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FOREWORD 


MUMPS-11 is an interactive, single-language, multi-user time-sharing 
system that allows access to a common data base. The capabilities of 
the system are primarily oriented towards string manipulation using a 
high-level language. The system relieves the user of most of the 
concern for programming peripheral devices or for structuring data 
bases in the traditional sense. 


Language processing by the system is in every sense interpretive. 
Each line of code undergoes identical processing each time it is 
executed (intermediate code is not generated). The MUMPS applications 
programmer need not be concerned with problems associated with driving 
peripheral equipment or programming in assembly language. The 
programmer's only concern should be the development of a proper 
logical hierarchy for the data base, and the development of logic for 
the data processing requirement. 


The MUMPS language is supported by a stand-alone operating system. In 
addition to implementing the MUMPS language and providing all 
operating system capabilities, the system affords the user a unique 
data base structure and access method. Data which is referred to 
symbolically is automatically stored and linked in a tree structure. 
Tke physical allocation of mass storage for the tree-structured data 
base is accomplished by the operating system. The data base thus 
created is available to other users in the system. 
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PREFACE 


This manual provides reference information for system managers. and 
operators of the MUMPS-11 software. It is assumed that the user has 
read and understood the related MUMPS-11 documentation listed below. 
MUMPS-11 Language Reference Manual (DEC-11-MMLMA-D-DN1) 
Elements of the language, the character set, programming 
modes, program structure, data modes, numbers, strings, 
literals, constants, and variables. 
Expressions: how to form them and how they are evaluated. 
Commands: meaning, syntax, arguments, and examples of use. 
Functions: meaning, syntax, arguments, and examples of use. 


MUMPS-11 Programmer's Guide (DEC-11-MMPGA-E-D) 


This manual provides all information required to create, execute, and 
save MUMPS-11 programs. 


System Overview: MUMPS-11 hardware/software environment and 
functional description of the operating system. 


Terminal Usage: log-in/log-out procedures, terminal types, 
special keyboard control characters. 


Programming Techniques: creating programs, loading 
programs, storing programs, program size considerations, 
using system variables, conserving space. 


Using I/0 Devices: general concepts of input/output, 
specific device characteristics. 


Library Utility Programs: functional characteristics, how 
to run them. 


MUMPS-11 Programmer's Reference Card (DEC-11-MMPCA-D-D) 


Pocket reference card containing: command and function 
summaries, messages, symbology, character set, etc. 


Introduction to MUMPS-11 Language (DEC-11-MMLTA-C-DN1) 
Step-by-step tutorial introduction to the MUMPS-1l Language. 


MUMPS-11 Release Notes (DEC-11-MMGSA-B-D) 


xiii 


An overview of the MUMPS-11 software package containing 
useful hints and tips for MUMPS-11 users. 


Sources of Supporting Information 


The following paragraphs list applicable PDP-11 and MUMPS-11 
documentation. 


Standard PDP-11 Documentation 


PDP-11/15, PDP-11/20, PDP-11/34, PDP-11/40, PDP-11/45, PDP-11/50, 
PDP-11/70 PROCESSOR HANDBOOKS 


Contain information on System Architecture, Addressing Modes, 
Instruction Set, Programming Techniques, Arithmetic Element 
Operations. 

PDP-11 Peripherals and Interfacing Handbook 

Contains programming, information on all PDP-1l peripheral devices, 


including: Teletype’, LA30/LA36 DECwriters, VT05/VT50, VT52 and 
vT55 video displays”, disks, DECtape, magtape and paper tape. 


MUMPS-11 Documentation 


In addition to this manual, the following MUMPS documents are 
relevant: 


MUMPS-11 Language Reference Manual 
Language Fundamentals, Syntax, Operator Commands and Functions 
MUMPS-11 Programmer's Guide 


System Overview, I/O Devices, Using the Terminal, Programming 
Techniques, Library Utility Programs 


PDP-11 MUMPS Programmer's Reference Card 


Summary of Syntax Operators, System Variables, Commands, Functions, 
Error Messages and System Utility Programs 


Introduction To MUMPS-1l Language 
Step-by-step tutorial approach to the MUMPS-11 Language 
MUMPS-11 Release Notes 


An overview of the MUMPS-11 software package containing useful hints 
and tips for MUMPS-11 users. 


1. Teletype is a registered trademark of the Teletype Corporation. 

2. Additional information on the vT05, VvT50, VT52 and VT55 video 
terminals is provided in DEC-00-H4AC-D, DEC-00-OVT5A-A-D, 
EK-VT5X-OP-001 and EK-VT55A-TM-002, respectively. 


xiv 


The following symbols are used throughout this manual: 


Symbol Definition 
~_ Used as 


(aa) Used 
CTRL Used 
CTRL 


UNDERLINING Used 


4U or “*U Used 


line or command terminator - use either 
Carriage RETURN or ALTMODE. 


to place spaces where desired. 


with special system control 
key while striking designated character. 


with examples of user-typed 


as echo for CTRL/U keyboard 


as echo for RUBOUT keyboard 


by operating BREAK key. 


\ Used 
BREAK Used 
Used to 
chosen. 


indicate that one of the 


XxV 


characters. Depress 


terminal input. 
command. 


command. 


enclosed items must be 
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CHAPTER 1 


INTRODUCTION 


This manual provides reference information for system managers. and 
operators using the MUMPS-11 time-sharing system. 


The first three chapters are intended to help new users build and 
configure a MUMPS-11 system for the first time. These chapters 
contain procedures for building, loading, system generation and 
initialization. Each operation is described in a simple step-by-step 
fashion so that a MUMPS system can easily be brought into operation. 
As the user gains familiarity with the system through actual 
Operation, more sophisticated operating techniques can be employed. 
Chapters 4, 5 and 6 contain reference information needed by the MUMPS 
system manager/operator to maintain the MUMPS system. 


This chapter summarizes the contents of the manual as a whole and 
lists associated documents, system software, and materials required to 
install a MUMPS-11 system. 


Chapter 2 describes how to run the MUMPS System Builder program in 
order to select and link together the various DEC- and user-supplied 
modular software components of the MUMPS-11 system into a basic system 
that is ready for system generation. 


Chapter 3 describes the system-generation process including: how to 
load the System Generator program (SYSGEN), preoperational 
considerations, and detailed descriptions of each of SYSGEN's 
questions and the appropriate responses. Following the procedures in 
this chapter, the user specifies the particular hardware environment 
desired, and the MUMPS-11 system is tailored to those specifications. 


Chapter 4 contains reference data on the use of the MUMPS-1l1 console 
terminal and the PDP-11 Control Console Switch Register switches. 
Also provided is information concerning loading and starting the 
system, creating system backup, and system shutdown. 


Chapter 5 describes MUMPS-11 system error detection features and 
various recovery procedures for both hardware and software errors. 


Chapter 6 describes how to use the MUMPS-1l System Utility Programs. 
(Library Utility Programs are described in the MUMPS-11 Programmer's 
Guide.) These programs provide the system Manager/operator with the 


tools necessary to maintain the system on a day-to-day basis. 


1.1 HOW THE MUMPS-11 SYSTEM IS SUPPLIED 


The MUMPS-11 software kit is supplied on magtape or RKO5 and RK06 
cartridges, It contains the MUMPS System Builder and program object 
modules, MUMPS SYSGEN, the System and Library Utilities, and the MUMPS 
Backup and Utility System. 
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INTRODUCTION 


1.1.1 MUMPS-11 System Builder 


The MUMPS-11 System Builder contains the System Build operating system 
and System Build programs that are necessary to generate a basic MUMPS 
system, and the program object modules for the MUMPS-11 operating 
system. 


In addition to the tape containing the MUMPS SYSGEN and Utility 
Programs, and the tape containing the MUMPS Backup and Utility System, 
there are four versions of System Build tapes for use with the 
different disk types. Depending on which disk type is in your 
configuration, you can choose one of the four System Build tapes (see 
Table 1-1). The tape you choose will be used to create your system 
disk. 


Table 1-1 
MUMPS-11 Tape Identification 


Tape Name 7-Track 9-Track 
Magtape Kit Magtape Kit 


MUMPS System Builder 
(RKO5 image) 


MUMPS System Builder 
(RKO6 image) 


MUMPS System Builder 
(RPO2, 03 image) 


MUMPS System Builder 
(RPO04, 05, 06 image) 


MUMPS SYSGEN and Utility 
Programs 


MUMPS Backup and Utility 
System 


1.1.2 MUMPS SYSGEN, System and Library Utility Programs 


The MUMPS-11 SYSGEN and Utility Software consists of the programs 
listed below. Associated subprogram names are shown in parentheses. 


System Utility Programs: 


BCS Broadcast 

CTK System Caretaker (CKO) 

DAT Date Set 

DBT Disk Block Tally (TAL, KIL) 
DMP Disk Block Dump (DCB) 


%GP 
KTR 


MSP 


RKC 
RSJ 
RST 
ss 


SDP 


SIF 
SsD 
STU 


SYSGEN 


TIM 


TPl 
through 
TP8 
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Global Place (%MU) 


Caretaker Reporter 


Modify System Parameters (MSU, %MU, MSD, MBP, MUX, KIL, 


MMD) 

Copy RKO5 Disk Packs 
Restore Job 

Restore Devices 
System Status 


Sequential Disk Processor Space Allocator (SDl, 
SD3, KIL, TAL) 


System Information (SS) 
System Shutdown 


System Startup (%T, %D, CTK) 


MUMPS System Generator (SGl through SG8, MSU, %MU, 


MBP, MUX, MMD) 


Time Set 


System Test Package 


Library Utility Programs and Subroutines: 


3D 

SFD 
%GD 
$GL 
%GR 
%GS 
$GT 
SGU 
SGV 
$10 
SIU 
30D 
SOP 
%PD 


SPL 


Date Subroutine 

Fast Program Directory Lister 
Global Directory 

Global Lister 

Global File Restore 

Global File Save 

Global Trace 

Global Utilization 

Global View 

I/O Device Assignment Subroutine 
IN USE Message 

Octal/Decimal Converter 
User/Operator Communicator 
Program Directory Lister 


Program Load 


SD2, 


MSD, 
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SPS Program Save 
$T Time Subroutine 


In addition, a program editor resides in t%. 


1.1.3  MUMPS Backup and Utility System 


The MUMPS Backup and Utility System permits the creation of physical 
backup on any user-specified mass storage media supported by MUMPS. 
The MUMPS system manager may backup or save the contents of any 
MUMPS-created disk, tape, global file directory or individual global 
file. For further details, refer to Appendix I. 


1.1.4 Documentation 


The following subset of the documentation described in Section 1.1 is 
provided as part of the MUMPS-11 software package: 


MUMPS-11 Language Reference Manual 


MUMPS-l1l Programmer's Guide 
MUMPS-ll Operator's Guide 


Introduction to MUMPS-ll Language 
MUMPS-11 Programmer's Reference Card 
MUMPS-1l Release Notes 


1.2 REQUIRED MATERIALS 


In order to create backup copies of a system, a number of certified 
DECtapes, magtapes and disk packs may be needed. However, no specific 
recommendations can be made as to the quantity of these materials. 
Such a determination depends directly upon both the user's hardware 
configuration and the specific backup procedures that are to be 
utilized. For any particular hardware configuration, several 
different backup procedures can be employed. 


CHAPTER 2 


BUILDING THE BASIC SYSTEM 


2.1 INTRODUCTION 


MUMPS-11 software is constructed from a number of modules that are 
supplied to the user as binary files (object modules). Some of these 
modules, like the interpreter, I/O Processor, time-sharing monitor, 
and others, must always be part of the system. Other modules, which 
implement optional system hardware/software features, such as floating 
point operations, additional I/O devices and terminals or sequential 
disk processing, can be included or omitted as desired. Special 
user-constructed modules for non-standard devices can also be 
included. This lets each user tailor the system to his exact needs 
for both hardware and_ software. This is a two-step process. The 
first step consists of selecting a group of modules that suit the 
user's hardware configuration, then linking those modules to form the 
Basic System. These procedures are described in this chapter. The 
Basic System is a special minimum capability system, the sole purpose 
of which is to allow operation of the MUMPS System Generator Program 
(SYSGEN) . This is the second step in the MUMPS configuration process 
and is described in Chapter 3. 


2.2 SUMMARY OF OPERATIONS 


The procedures for building the Basic System are automated by a 
special program called the MUMPS System Builder, or simply SYSBLD. 
SYSBLD runs an interactive question/answer session with the system 
Manager to obtain the required information to build the system. 
SYSBLD then uses the MUMPS SYSBLD programs, PIP, IND, and fTKB_ to 
create the Basic System’, See Figure 2-1 for a typical SYSBLD 
session. When SYSBLD completes its operation, the Basic System is 
ready to be loaded and started, in preparation for system generation 
(Chapter 3). A loadable copy of the Basic System (on either magtape 
or disk cartridge) can be used as a backup to the system. Two copies 
of the system load map are output to aid the system manager in using 
the system and in diagnosing error conditions. One copy is placed on 
the system backup media, and the other is output to either the console 
terminal or the line printer. The principal steps in building the 
Basic System with magtape distribution are summarized in Table 2-1. 


l. This is a special configuration of the MUMPS System Build (MSB) 
Operating System to be used only for building a MUMPS-11 system. 
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Table 2-1 
Summary of System Build Steps-Magtape Distribution 


Mount the DSC (Disk Save and Compress copy utility) magtape on 
drive 0. 

Boot the device and DSC program will come up. 

Mount the MSB (MUMPS System Build) tape on drive 0. 


Enter the command to copy the system image onto the system 
disk. 


Boot the disk to bring up the System Builder. 


Mount the MUMPS object tape on Drive 0, and answer’ the 
questions on the console. 


Type @BUILD to initiate the System Builder question/answer 
session. 


2.3  PREOPERATIONAL INFORMATION 


This section describes the information required by the system manager 
prior to building the system. 


2.3.1 General 


The system manager should be familiar with the PDP-1l hardware 
configuration to be used. . Specifically, the following information 
should be on hand: 


e Processor type (PDP11/10, 11/20, 11/34, 11/40, 11/45, 11/50 or 
11/70) 


e Availability of hardware arithmetic unit(s) (EAE, EIS, or FPP) 
e Memory size 


e Availability and type of: magtape, data sets, DH-1ll, D2z-11 
Multiplexers, and CPU-to-CPU devices (via DL-11 controllers) 


e Whether the Sequential Disk Processor (described in the 
MUMPS-11 Programmer's Guide) is desired 


e Whether the $M Function is desired 


2.3.2 Reserved Devices 


The system manager can incorporate up to four standard or non-standard 
I/O devices into the system as Reserved Devices. In addition to 
interfacing the device and its controller to the PDP-11l processor, the 
programmer must write a device driver program to operate the device. 
Design criteria and instructions for writing these device drivers are 
provided in Appendix I, of the MUMPS-11 Programmer's Guide. The 
drivers must be available at system-build time in object module 
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(binary file) form. System managers or programmers who are to write 
their own drivers for reserved devices, must have a good working 
knowledge of the System Builder software, including the PDP-11 
assembler and the System Utility Programs. 


2.4 ERROR CONDITIONS 


If the user discovers a typing error in a line before the terminating 
Carriage RETURN is typed, it can be corrected in one of two ways. One 
method is to use the RUBOUT key to delete single characters, beginning 
with the last character typed. Each time RUBOUT is typed, a character 
is deleted, progressing from right to left. The other method is to 
use the CTRL/U function to delete the entire line (press CTRL key and 
type aU). Errors discovered after the Carriage RETURN is typed will 
simply cause the question to be reissued. Logical errors, such as 
responding with a NO answer when a YES is desired, can be corrected 
only by initiating a new SYSBLD session. These are the only types of 
errors a user should encounter. 


2.5 SYSTEM STARTUP WITH BOOTSTRAP ROMS 


The step-by-step startup procedure for using the various bootstrap 
ROMS is described in the following sections. 


2.5.1 Using BM792-YB Bootstrap ROM 


The following procedures are used in starting up the BM792-YB 
bootstrap ROM: 


1. Depress HALT. 

2. Set the console switches to 173100. 
3. Depress LOAD ADDRESS. 
4 


. Enter the address of the load device in the console switches: 


RK11 Disk 177406 
RK611 Disk 177462 
RP11 Disk 176716 


TCll DECtape 177344 
5. Lift up the HALT key. 


6. Press START. 
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2.5.2 Using MR11-DB Bootstrap ROM 


The following procedures are used in starting up the MR11-DB bootstrap 
ROM: 


1. Depress HALT. 
2. Enter the address of the load device in the console switches: 
RK611 Disk 173100 
RK11 Disk 173110 
TCll DECtAPE 173120 
TM1l1l Magtape 173136 
RP11 Disk 173154 
3. Depress LOAD ADDRESS. 
4. Lift up the HALT key. 


5. Press START. 


2.5.3 Using BM873-YA Bootstrap ROM 


The following procedures are used in starting up the BM873-YA 
bootstrap ROM: 


1. Depress HALT. 


2. Enter the address of the load device in the console switches: 


RK611/RH70 Disk 173000 
RK11/RH70 Disk 173010 
TCll DECtape 173030 
TM11 Magtape 173050 
RP11 Disk 173100 
KL11/DL11 173210 
TA11 Cassette 173230 
PCll Papertape 173312 


3. Depress LOAD ADDRESS. 
4. Lift up the HALT key. 


5. Press START. 


2.5.4 Using BM873-YB Bootstrap ROM 


The following procedures are used in starting up the BM873-YB 
bootstrap ROM: 


1. Depress HALT. 


2. Enter the address of the load device in the console switches: 


RH11/RS04 Disk (unit 0) 173000 
RH11/RS04 Disk (unit in switch register) 173002 
RK11 Disk (unit 0) 173030 
RK11 Disk (unit in switch register) 173032 
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TCll DECtape (unit 0) 173070 
TM11 Magtape (unit 0) 173110 
RK611 Disk 173136 
RH11/RH70/TM02/TU16 Magtape (unit 0) 173150 
RH11/RH70 Device Combination (unit zero) 173230 
RH11/RH70 Device Combination (unit in 173232 
switch register) 

RH11/RH70/RP04 Disk (unit 0) 173320 
RH11/RH70/RP04 Disk (unit in switch 173322 
register) 

RP11/RP02/RP03 Disk (unit 0) 173350 
RP11/RP02/RP03 Disk (unit in switch 173352 
register) 

KL11/DL11 Console Terminal Reader 173510 
PCll Papertape Reader 173620 


3. Depress LOAD ADDRESS. 


For units other than zero, enter unit number in switch 
register. 


4. Lift up the HALT key. 


5. Press START. 


2.5.5 Using M9301-YA or M9301-YB Bootstrap ROM (PDP-11/34) 


The following procedures are used in starting up the M9301-YA or 
M9301-YB bootstrap ROM. 


1. Press the console buttons marked CNTRL and HLT/SS 
simultaneously. 


2. Press the console buttons marked CNTRL and BOOT 
simultaneously. 


3. In response to the "$" prompt on the console terminal, enter 
one of the following: 


DB - RH11 Disk M9301-YB only 
DK - RK1l1 Disk 
DP - RP11 (RP02/03) Disk 


DS - RSO4 Disk M9301-YB only 
DT - TCll DECtape 
MM - TMO2/TU16 Magtape M9301-YB only 


MT - TM11/TU10 Magtape 
PR - PC11/PR11 Paper Tape Reader 
TT - KL11/DL11 Console Terminal Reader 


The two alphabetic characters may be followed by an optional 
single octal digit for bootstrapping from units other than 
zero. Such alphabetic characters (and octal digit) must be 
terminated by a Carriage RETURN. 


2.6 DETAILED DESCRIPTION OF OPERATION - MAGTAPE DISTRIBUTION 

This section provides detailed procedures for building the Basic 
System for MSB software and MUMPS modules that have been supplied on 
Magtape. (See Section 2.7 for disk pack distribution.) 
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NOTE 


All user keyboard responses are 
terminated by Carriage RETURN. In the 
examples that accompany the text, user 
responses are underlined. 


2.6.1 Loading Procedures - MUMPS-11 System Builder 


The following paragraphs describe the procedures to be followed when 


loading 


and starting the MUMPS System Builder (MSB) from magtape. As 


described in Chapter 1, the MSB software is supplied either on magtape 
(7- or 9-track), or RKO5 or RKO6 cartridge disk. 


NOTE 
Prior to building your system, be sure 


to format any fresh disk packs with MBU 
(see Appendix I). 


Mount the DSC (Disk Save and Compress) utility tape on _ the 
Magtape drive as follows: 


A. Make sure the write enable ring is removed from the tape. 
B. Mount the tape on drive number 0. 

C. Position the tape at LOAD POINT (see Appendix G). 

D.. Set the ON LINE/OFF LINE switch to ON LINE. 


Boot the magtape by activating the hardware read-only memory 
(ROM) bootstrap as described in Section 2.5. 


(The copy utility DSC will now be loaded and started.) 


Dismount the DSC tape and mount the MSB (MUMPS System 
Builder) tape on drive 0. 


Copy the MSB system from magtape onto a formatted disk as 
shown below. If the disk has not been formatted, see 
Appendix I. 

A. Load a scratch disk to be used for MSB on disk drive 0. 


B. If the MSB tape is mounted on a TU10 or TS03 magtape 
drive, type the following command to DSC: 


DSC>MT: /VEC=224_/ 


Cc. If the scratch disk is mounted on an RPO2 or RPO3 disk 
drive, type the following command to DSC: 


DSC>DP: /VEC=254./ 
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NOTE 


These two command lines must be typed (if 
applicable to your system configuration) due to 
a conflict between the vectors for these devices 
and for other possible system devices. 


D. Type the following command line to DSC in order to 
transfer the proper version of MSB for your disk from 
the magtape. 


DSC>xx:=mm: xxSYS_,/ 


where xx= DK for RKO5 
DM for RK06 
DP for RP02,03 
DB for RP04,05,06 


mm= MT for TU10 or TSO3 magtape drives 
MM for TJU16 magtape drives 


(The tape will now be searched for the correct MSB file which 
will be copied to the disk. When this is completed, DSC will 
respond with "DSC>".) 

Halt the system and remove the MSB tape. 


Boot the disk in the manner described in Section 2.5. The 
MUMPS System Builder should announce itself as follows: 


** MS B ** V4B 
After several intermediate lines of printing, the user will 
be asked to enter the time and date with the following 
message: 
>* PLEASE ENTER TIME AND DATE (HH:MM MM/DD/YY) [S] 
The user should respond with the correct time and date. 
Example: 

20:55 2/6/77.) 


After entering this information, mount the MUMPS object tape 
on drive 0. 


MSB will request the user to enter the type of magtape device 
containing the MUMPS object tape. If this is a 
TM-11/TU10-TS03 type drive, respond with MT. If this is a 
TJU16/TU16 type drive, respond with MM. 


All information from the MUMPS object tape will be copied 
onto the disk. 


Once this process has completed, MSB will display the various 
options available to the _ user. At this point, the MUMPS 
object tape should be dismounted. 
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12. If the user has any user device drivers for MUMPS, they 
should be transferred to the MSB disk. These device drivers 
must be in an RSX-11M V3 object module format. Section 2.6.2 
describes this procedure. 


13. In order to start the build procedure for MUMPS, the user 
should type "@BUILD". 


(Figure 2-2 shows a SYSBLD startup with magtape distribution.) 


NOTE 
If MSB does not print its identification 
and the processor halts, an error 
occurred in the copy operation. Retry 
the procedure beginning at Step l. If 


the error persists, it will be necessary 
to obtain a new tape. 


2.6.2 User-Created Object Modules 

Once MSB is loaded, any object modules of drivers for reserved 1/0 
devices must be loaded onto the system disk. This is accomplished, 
using PIP as follows: 

1. Mount the tape (after removing its write enable ring) 
containing the device driver object modules, on _ the 
appropriate drive. 

2. Select a drive unit number from 0-7. 

3. Set drive control switches as follows: 

A. Magtape Input 
a. Position tape at LOAD POINT (Appendix G). 
b. Set OFF LINE/ON LINE switch to ON LINE. 
B. DECtape Input 
a. Set the WRITE ENABLE/WRITE LOCK switch to WRITE LOCK. 
b. Set the LOCAL/REMOTE switch to REMOTE. 


4. Transfer each module from the tape to the system disk by 
using one of the following command strings, as applicable: 


Magtape Input 


>PIP SY:<MTn:filnam.OBJ./ TU10 or TSO3 
>PIP SY:<MMn:filnam.OBJ~/ TJU16 


DECtape Input 


> 

>PIP SY:<DTn:filnam.OBJ~/ 
where: 

n = unit number 
filnam = file name of object module 
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When all modules are transferred, terminate PIP operations by typing 
CTRL/Z, and carriage RETURN. 


>4Z/ 


2.6.3 Answering SYSBLD Questions 


Section 2.8 describes each SYSBLD question along with the appropriate 
responses. Answers to SYSBLD questions are either Y (for YES) or N 
(for NO) followed by a Carriage RETURN. 
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SYSTEM BUILD COMMAND FILE FOR MUMFS~11 V4B 


wi et 


IF &.ex/PU 


wy 


ae 


SE er DE a> JE er SE <a> SE er SE a> FE er JE er JE “a> SE er SE <a> er “TD we wee 


IS YOUR COMPUTER A PDP-11/45 OR PIP-11/70? CY/NISY 

NOES YOUR COMPUTER HAVE A FLOATING FOINT PROCESSOR? CY/NI3Y 
DOES YOUR COMPUTER HAVE MORE THAN 28K? CY/NI¢Y 

DOES YOUR COMPUTER HAVE RFO4s RFOS» OR RFOS DISKS? CY/NIZY 
DOES YOUR COMPUTER HAVE RK611/RKO6 DISKS? CY/NISN 

DOES YOUR COMPUTER HAVE TM11/TU10-TSO3 MAGTAPE? CY/NIIN 
DOES YOUR COMPUTER HAVE TJUL6/TUL6 MAGTAPE? CY/NItY 

DO YOU WANT SUPFORT FOR EBCDIC TAFE FORMATS? CY/NI:N 

nO YOU HAVE DECTAFES ON YOUR COMPUTER? CY/NI:Y 

DO YOU WANT SUPPORT FOR THE SEQUENTIAL DISK FROCESSOR? CY/NI3N 
DO YOU WANT THE $M FUNCTION? CY/NI3N 

DO YOU HAVE DH-11 MULTIPLEXERS ON YOUR COMPUTER? CY/NI:Y 

nO YOU WANT DH-11 MODEM SUPPORT (DM-1L1BB)? CY/NI3Y 

DO YOU HAVE [1Z-11 MULTIPLEXERS ON YOUR COMPUTER? CY/NIU2Y 


DO YOU WISH LOWER CASE TERMINAL INPUT? CY/NIEN 


° 
> 
Ss 
> 
wey 
a 

> 
> 
> 
oe 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
oo 
> 
> 
> 
> 
a 
> 
> 
“ 


nO YOU WANT SUPFORT FOR CFU-CFU COMMUNICATIONS (DL-11)? CY/NIEN 
nO YOU WANT DIMC-11 SUPPORT? CY/NISN 
nO YOU WANT SUPFORT FOR DL-11E DATASETS? CY/NIiN 


nO YOU WANT SUPFORT FOR INTER-JOB COMMUNICATION? CY/NI3Y 


sar 36 a> 3G ee 36 <a> 9G E> SE Or JE > DE Or IE o> 


ee i a 


DO YOU HAVE A CARD READER? CY/NI3Y 

nO YOU WISH 029 CODE SUPPORT? CY/NISY 

nO YOU WISH 026 CODE SUPFORT? CY/NI3N 

WILL YOU BE ADDING USER DEVICE DRIVERS? CY/NIIN 
WE WILL NOW TASK BUILD YOUR NEW SYSTEM 


DO YOU WANT THE MAP ON THE LINE PRINTER? CY/NI3Y 


Figure 2-1 Typical System Build Session 
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2.6.4 Restarting the Basic System from DECtape or Magtape 

SSE Sea Se eee Pee SPE Or meg cape: 
When MSB completes its operation, the MUMPS Basic System resides on 
DECtape or magtape. Since the user may not wish to proceed with MUMPS 
system generation until some later time, the following paragraphs 
describe how to restart the Basic System using the backup tape created 
by MSB. 


1. Mount the MSB-created backup tape on the appropriate drive 
(DECtape or magtape). 


2. Set the drive control switches as follows: 
A. DECtape Drives 
a. Set the unit number switch to 0. 
b. Set the LOCAL/REMOTE switch to REMOTE. 
c. Set the WRITE LOCK/WRITE ENABLE switch to WRITE LOCK. 
B. Magtape Drives 
a. Set the unit number to 0. 
b. Remove the write enable ring from the tape reel. 
c. Set the OFF LINE/ON LINE switch to ON LINE. 

3. For all PDP-1ll's (except the PDP-11/34) boot DECtape or 
Magtape by activating the hardware read-only memory (ROM) 
bootstap via the SWITCH REGISTER switches, as described 
below: 

A. Set the console ENABLE/HALT switch to HALT. 

B. Set the console SWITCH REGISTER switches to the hardware 
Pcie ROM address for DECtape or magtape (see Section 

C. Press the LOAD ADRS switch. 

D. Set the ENABLE/HALT switch to ENABLE. 

E. Press the START switch. 

4. For the PDP-11/34, boot DECtape or magtape by activating the 
read-only memory (ROM) bootstrap via the console buttons, as 


described below: 


A. Press the console buttons marked CNTRL and HLT 
simultaneously. ~ 


B. Press the console buttons marked CNTRL and BOOT 
simultaneously. 


C. When the system prints a $, respond by typing either 'DT' 
for DECtape or 'MT' for magtape. 


The tape should now spin, indicating that MUMPS is being loaded. When 
the tape halts, wait two minutes, LOWER ALL SWITCHES and then sign 
onto MUMPS by hitting CTRL C (press CTRL and C on the terminal 
simultaneously). 
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The MUMPS image is transferred from the tape to memory, where it is 
automatically started. Thereafter, MUMPS waits for the user to 
log-in, in preparation for system generation (see Chapter 3). If 
MUMPS must be halted during SYSGEN for any reason, it can be restarted 
using the bootstrap loader for magtape or DECtape, as described in 
Section 2.6.4. 


kK M GS B kx 

SRED ONROt#SYO$ 

>MQU TIKOSMSBV4ER 

=@CL» 2ISTARTUFP 

’x PLEASE ENTER TIME ANID GATE CHHSMM MM/DD/YY) [CSI2 2/6/77 19335 
STIM 276/77 197335 


MUMFS V4B SYSTEM BUILD. MOUNT MUMPS QRJECT TAFE ON 
QIRIVE O- 


MM ~ TJUL6/TUL6 MAGTAPE 
MT ~ TMLI/TULO-TSO3 MAGTAFE 


Be ee er vce ep ae ee 


2k WHAT IS THE TYPE OF MAGTAFE DRIVE (MM OR MT) CSI? MT 
SLOA MT? 
SINS [Cle SOUFLX 
2 SYR/RS=MT EC Ky eK KIO 
. MTE 
7 /UTCet Ly 2d 
“TF STARTUF.. CMD/NV#C 2002200 1S TARTUP. CMD 
SBET /UTC#I 200% 2007 


@BUILD ~ BUILD. A NEW VERSION OF MUMFS 
@MBU ~- LOAD MBU 
@MUMFS ~ LOAL LAST BUILD MUMFS BASELINE SYSTEM 


{Ei ey ce er er ce > 


=@ SEQF> 
S@BUTLE 


Figure 2-2 SYSBLD Startup with Magtape Distribution 


2.7 DETAILED DESCRIPTION OF OPERATION - DISK PACK DISTRIBUTION 


This section provides detailed procedures for building the Basic 
System for MSB software and MUMPS modules which have been supplied on 
disk (RKO5 or RK06). (See Section 2.6 for magtape distribution.) 


NOTE 
All user keyboard responses are 
terminated by Carriage RETURN. In the 


examples that accompany the text, user 
responses are underlined. 
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2.7.1 Preoperational Information 


The disk pack distribution media consists of two RKO5 or RKO6 
cartridges. One of the cartridges contains the MUMPS System Builder 
(MSB) operating system, the MUMPS object modules, and the MUMPS Backup 
and Utility System. The other cartridge contains a runnable 
pre-configured MUMPS system with minimal hardware support, the MUMPS 
SYSGEN programs, the System Library, and the Editor. 


The System Manager uses the MSB cartridge to create a new basic MUMPS 
system, and then "merges" the new basic MUMPS system with the MUMPS 
cartridge during SYSGEN to produce a customized MUMPS System. This 
process can be repeated as frequently as desired. 
CAUTION 
Do not proceed without making a copy of 


both disk cartridges (refer to Appendix 
I for instructions). 


2.7.2 Loading Procedures - MUMPS-11 System Builder 
ee ee ee YOLEN burtcer 


The following paragraphs describe the procedures to be followed when 
loading and starting the MUMPS System Builder (MSB) from disk. 


1. Load the disk containing the MSB software on unit 0 (write 
enabled). 


2. For all PDP-1l's, except the PDP-11/34, load and start MSB by 
activating the hardware read-only memory (ROM) bootstrap via 
the SWITCH REGISTER switches, as described below. 

A. Set the console ENABLE/HALT switch to HALT. 


B. Set the console SWITCH REGISTER switches to the 
appropriate address for RK11 loading (see Section 2.5). 


Cc. Press the LOAD ADRS switch. 
D. Set the ENABLE/HALT switch to ENABLE. 
E. Press the START switch. 
3. For the PDP-11/34, load and start MSB from the system disk by 
using the ROM bootstrap via the console buttons, as described 


below: ? 


A. Press the console buttons marked CNTRL and HLT 
simultaneously. 


B. Press the console buttons marked CNTRL and BOOT 
simultaneously. 


Cc. When the system prints a $, respond by typing 'DK', to 
boot the disk. 


At this point, the MUMPS System Builder starts and identifies itself 


1. For information on the 11/34 console, and instruction set, refer to 
the KY11-LB Programmer's Console Maintenance Manual, EK-KY11L-MM-001, 
and the PDP 11/34 Processor Handbook, EB 05710 76. 
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at the console terminal by printing its name and version number: 
** MS B ** V4B 


Respond to the time and date message in the format specified. 
Instructions will be displayed indicating the various options 
available to the user. In order to start the system build procedure, 
type @BUILD. Refer to Figure 2-3 for a SYSBLD Startup with RK05 
distribution. 


2.7.3 Running SYSBLD 


Once @BUILD has_ been typed, SYSBLD begins its interactive 
question/answer session with the user. Section 2.8 describes each 
SYSBLD question with the appropriate responses. Once these questions 
have been answered, the interactive portion of SYSBLD's operation is 
complete and the actual system building process begins. SYSBLD calls 
the various MSB system programs required to perform this task. SYSBLD 
then prints out a message stating that the user may now boot MUMPS 
(for all RK disks, type: BOO MUMPS). 


If the user wishes to complete the system generation at this time, the 
MUMPS cartridge should be mounted on drive 0, and the user should sign 
onto MUMPS with Control C and CALL the program SGl (see Section 3.7). 
The user should ensure that all console switches are lowered before 
signing onto MUMPS. 


KK OM S ROK V4 

PRED DKLt=SY0t 

>MOU DNL ?MSBV4E 

>@CLy 2ISTARTUP 

“ok FLEASE ENTER TIME ANID DATE (HHIMM MM/DD/YY] C833 19250 2/7/77 
=TIM 19850 2/7/77 


cord 


TYFE @BUILO TQ BUILD MUMPS V4k 
TYFE @MBU TO LOAD #*X MBU kx 


TYFE @MUMFS TO LOAD A BUILT MUMFS SYSTEM 


nt 
a 
oar 
oF 
na 
oF 
Pars 
oF 
se 
oy 
7g 


@ SEOF> 
>@BUILE 


Figure 2-3 SYSBLD Startup with RKO5 Distribution 


2.7.4 Restarting the Basic System From Disk 


When MSB completes its operation, the MUMPS Basic System (MSB) resides 
on disk. Since the user may not wish to continue with system 
generation until a later time, the following paragraphs describe how 
to restart the Basic System using the MSB disk: 


1. For all PDP-1l's except the PDP-11/34, boot the MSB disk by 


activating the hardware read-only memory (ROM) bootstrap, as 
follows: 
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A. Set the console ENABLE/HALT switch to HALT. 


B. Mount and load the MSB disk of the disk drive. 


C. Set the console SWITCH REGISTER switches to the 
appropriate address for disk (see Section 2.5). 


D. Press the LOAD ADRS switch. 
E. Set the ENABLE/HALT switch to ENABLE. 
F. Press the START switch. 


2. For the PDP-11/34, boot the MSB disk by activating the 
hardware read-only memory (ROM) bootstrap, as follows: 


A. Press the console buttons marked CNTRL and HLT/SS 
simultaneously. 


B. Press the console buttons marked CNTRL and BOOT 
simultaneously. 


Cc. When the system prints a $, respond by typing 'DK' or 
"‘DM' for disk. 


3. MSB now resides in core. Boot MUMPS by typing: 
@MUMPS 
After the basic MUMPS system has been loaded, the MSB disk should be 


removed and the MUMPS SYSGEN program should be started as described in 
Section 3.7. 


2.8 SYSBLD QUESTIONS 
The SYSBLD program asks the user a-series of questions in order to 
determine the configuration of the Basic System. These questions are 


described below. Answers to SYSBLD questions are either Y (for YES) 
or N (for NO). 


IS YOUR COMPUTER A PDP 11/45 OR PDP-11/70? [Y/N]: 


If the MUMPS-11 system is being built to run on a PDP 11/45 or 11/70 
processor, type Y; otherwise, type N. If the answer is Y, SYSBLD 
skips the next question. 


DOES YOUR COMPUTER HAVE A FLOATING POINT PROCESSOR? [Y/N]: 


If this system has a floating-point processor, type Y; otherwise, 
type N. 


DOES YOUR COMPUTER HAVE MORE THAN 28K? [Y/N]: 


If the processor has more than 28K words of usable memory, (i.e., the 
system has the memory management option), type Y; otherwise, type N. 
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DOES YOUR COMPUTER HAVE RP04, RPO5, OR RPO6 DISKS? [Y/N]: 


If this system has RP04, RPO5 or RPO6 disks, type Y; otherwise, type 
N. If the system has an RPO04, RPO5, or RPO06 disk, but does not have 
EIS, it is an’invalid configuration under MUMPS-11. Therefore, SYSBLD 
ceases its system build and outputs the following error message: 


THE CONFIGURATION YOU HAVE SPECIFIED IS NOT SUPPORTED BY 
MUMPS-11. USE OF THE RH11/RJP04 DISK SYSTEM REQUIRES THE EIS 
INSTRUCTION SET. PDP-11/45 AND PDP-11/70 PROCESSORS HAVE THE EIS 
INSTRUCTIONS BUILT INTO THEM. 


DOES YOUR COMPUTER HAVE RK611/RK06 DISKS? [Y/N]: 


If this system has RK06 disks, type Y; otherwise, type N. 
DOES YOUR COMPUTER HAVE TM11/TU10-TSO03 MAGTAPE? [Y/N]: 


If this system has the TMl1 magnetic tape system, type Y; otherwise, 
type N. If the answer is Y, the following question is skipped. 


DOES YOUR COMPUTER HAVE TJU16/TU16 MAGTAPE? [Y/N]: 


If this system has the TJU16 magnetic tape system, type Yj; otherwise, 
type N. If the answer is N, the following question is skipped. 


DO YOU WANT SUPPORT FOR EBCDIC TAPE FORMATS? [Y/N]: 


This question is only asked if the user selected a magtape option. If 
N is answered to this question, there is a restriction to the ASCII 
character set. If Y is answered, the EBCDIC translation table is 
included, and the user's program can use both the ASCII and the EBCDIC 
character sets through use of the ASSIGN command. 


DO YOU HAVE DECTAPES ON YOUR COMPUTER? [Y/N]: 
If the system has the TCll DECtape option, type Y; otherwise, type N. 
DO YOU WANT SUPPORT FOR THE SEQUENTIAL DISK PROCESSOR? [Y/N]: 


If the MUMPS-11 system is to use the Sequential Disk Processor (SDP) 
software option, type Y; otherwise, type N. Refer to the MUMPS-11 
Programmer's Guide for a description of the SDP. 


DO YOU WANT THE SM FUNCTION? [Y/N]: 


The $M function allows standard arithmetic and relational arithmetic 
operations to be performed on numbers outside the normal range of 
MUMPS numbers. If you want to use the $M function, type Yj; 
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otherwise, type N. Refer to the MUMPS-11 Language Reference Manual 
for more information on the $M function. 


DO YOU HAVE DH-11 MULTIPLEXERS ON YOUR COMPUTER? [Y/N]: 


MUMPS-11 can support up to 65 terminals. When more than 17. terminals 
are to be used, the additional terminals can be operated through one, 
two or three DH-11l multiplexers (one DH-11 can operate a maximum of 16 
terminals). If DH-1ll's are to be used, type Y; otherwise, type N. 


DO YOU WANT DH-11 MODEM SUPPORT (DM-11BB)? [Y/N]: 


This question is asked only if you answered Y to DH-11 multiplexers. 
This feature provides support for the DM-1l1 modem control hardware 
available with the DH-1l interface. If modem support is desired, type 
Y; otherwise, type N. 


DO YOU. HAVE DZ-11 MULTIPLEXERS ON YOUR COMPUTER? [Y/N]: 


When more than 17 terminals are to be used, the additional terminals 
can be operated through one to six DZ-11 multiplexers (one DZ-11 can 
operate a maximum of eight terminals). If DZ-ll's are to be used, 
type Y; otherwise, type N. 


DO YOU WISH LOWER CASE TERMINAL INPUT? [Y/N]: 


This feature provides for lower-case terminal input. If Y is typed to 
this question, both upper- and lower-case characters can be sent to a 
MUMPS program from a terminal. If N is typed to this question, all 
lower-case characters will be converted to upper-case on all 
terminals. 


DO YOU WANT SUPPORT FOR CPU-CPU COMMUNICATIONS (DL-11)? [Y/N]: 


If central processor-to-central-processor communication using a DL-11A 
controller on a local (hardware) circuit is desired, type Y; 
otherwise, type N. If N is typed to this question, the following 
question is asked. 


DO YOU WANT DMC-11 SUPPORT? [Y/N]: 


The DMC-11 communications controller provides for high speed, reliable 
transmission of data to local or remote interconnected computers over 
a serial synchronous link. If support for the DMC-11 is desired, type 
Y; otherwise, type N. 


DO YOU WANT SUPPORT FOR DL-11E DATASETS? [Y/N] : 


MUMPS-11 provides full support for Bell type 103A datasets when 
connected to the system via DL-11E communications controllers. If one 
Or more datasets are to be used, type Y; otherwise, type N. 


2-17 


BUILDING THE BASIC SYSTEM 
DO YOU WANT SUPPORT FOR INTER-JOB COMMUNICATION? [Y/N]: 


If in-core job communication through a set of pseudo-devices is 
desired, type Y; otherwise, type N. 


DO YOU HAVE A CARD READER? [Y/N]: 
If a CR-1l card reader is to be used, type Y; otherwise, type N. 


DO YOU WISH 029 CODE SUPPORT? [Y/N]: 


This feature allows support for 029 formatted cards. If support is 
desired for these cards, type Y. If N is typed, 026 card support is 
assumed. 


DO YOU WISH 026 CODE SUPPORT? [Y/N]: 


This feature allows support for 026 formatted cards. If Y was typed 
to the previous 029 code question, this question asks if 026 code is 
to be supported as well. Type N if 026 code support is desired; 
otherwise, type N. 


WILL YOU BE ADDING USER DEVICE DRIVERS? [Y/N]: 


MUMPS utilizes up to four user-specified non-standard I/O devices. 
Each device is operated by a user-created I/O device driver program 
module. The object module for each device used in the system must be 
transferred onto the MUMPS System Build device. If user device 
drivers are to be part of the MUMPS-11 configuration, type Y; 
otherwise, type N. If Y is answered to this question, SYSBLD prompts 
the user with the following question. 


WHAT IS THE NAME OF YOUR DEVICE MODULE? 
User enters a six-character name, for example: 


XXXDRV_/ 


where XXX is the three-character name for the device module. SYSBLD 
then prints out: 


WE WILL NOW PAUSE WHILE YOU TRANSFER YOUR OBJECT MODULE ONTO THE 
SYSTEM DEVICE. 
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SYSBLD will pause while you transfer your drivers, after which time it 
will output the message: 


WE WILL NOW TASK: BUILD YOUR NEW SYSTEM. 


DO YOU WANT THE MAP ON THE LINE PRINTER? [Y/N]: 


If you want the memory allocation map to be printed on the line 
printer, type Y; if an N is typed, the map is output to your 
terminal. 


After this, a message prints out indicating that certain features of 
MUMPS were not required for your configuration. This message is 
normal, and always prints out at this time if any System Build 
questions have been answered N. 


The final question SYSBLD asks is: 


WHAT IS THE OUTPUT DEVICE? ("MM","MT","DT", OR "") [S]: 


This allows you to save the just-built Basic System. The output 
device can be TJU16 (MM), TU1O (MT), or DECtape (DT). Choosing the 
final option ("") indicates that you are saving your Basic System to 
the system disk. [S] indicates that string input is required to this 
question. 


This completes the interactive portion of SYSBLD's operation. At this 
point, the actual system building process begins. SYSBLD calls the 
' various MSB programs required to perform this task. 


CHAPTER 3 


SYSTEM GENERATION PROCEDURES 


3.1 INTRODUCTION 


This chapter describes the procedures to be followed when using the 
MUMPS-11 System Generator Program (SYSGEN) to tailor a MUMPS-11 system 
to the user's hardware/software environment. SYSGEN does not create a 
system, but modifies an existing one: the Basic System built as 
described in Chapter 2. SYSGEN can be used only with the Basic 
System. 


Modifications to some of the parameters of an existing (SYSGENed) 
'system can be performed using the Modify System Parameters (MSP) 
program described in Section 6.2.7. However, many modifications 
require a new SYSGEN. If a user already has an operational MUMPS 
system and wishes to reconfigure it, the SYSTEM MERGE option of SYSGEN 
can be used. A SYSTEM MERGE will tailor the basic system to the 
desired configuration while retaining the current data base. 
Otherwise, a user must perform a logical save of the data base, 
perform a normal SYSGEN, and restore the data base. 


The MUMPS-11 Basic System is a minimum configuration system consisting 
of: one terminal, one partition (4K words), one User Class Identifier 
(UCI) and Standard Programmer Access Code (PAC). 


When SYSGEN is loaded, it automatically begins an interactive dialogue 
with the user that covers all system aspects in a step-by-step manner. 
Once system generation is complete, the system manager is instructed 
to save the system on the disk. At this point he should create a 
backup copy on disk or tape. This can be done with the MUMPS' Backup 
and Utility System (see Appendix I). 


Should the system manager wish to perform a subsequent system 
generation, he must either build a new Basic System (see Sections 
2.6.1 or 2.7.2) or load a backup copy of that system (see Appendix I) 
before running the SYSGEN program. 


3.2 ORGANIZATION 
3.2.1 Program Structure 


SYSGEN, though logically a single program, is physically segmented 
into the following eight programs named: SGl through SG8. These 
separate programs were constructed to allow SYSGEN operation in a 4K 
word partition. As a part of the system generation process, SYSGEN 
also uses five subprograms of the Modify System Parameters (MSP) 
program: MSU (which calls MU), MSD, MUX, MBP and MMD. 
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3.2.2 SYSGEN Tape 


As described in Chapter 1, SYSGEN is supplied by DEC on magtape (see 
Section 3.7 for RKO5 and RKO6 distribution). These tapes are called 
SYSGEN tapes and contain both the System and Library Utility Programs 
and the System Test Package. As shown in Figure 3-1, the layout of 
these tapes is essentially the same. A single exception is that the 
first record on magtape is a label record. The first eight entries on 
the tapes contain the first eight program segments of SYSGEN (SGl - 
SG8) ; the remaining program (MSP) and the other system and Library 
Utility Program reside in the tape's library area. 


MAGTAPE 


LIBRARY 
SYSGEN PROGRAMS 


ae eas, 


NUMBER OF 
PROGRAMS 
WHICH FOLLOW 


Figure 3-1 SYSGEN Tape Logical Structure 


3.3 ANSWERING SYSGEN'S QUESTIONS 


User responses are terminated by a Carriage RETURN. Some questions 
are interdependent, and SYSGEN may ask additional questions as a 
result of the answer to a previous question. Answers to. other 
questions will cause SYSGEN to type a response to an answer. For 
example, for each UCI specified, SYSGEN will respond with the physical 
disk location of the associated directory. If an error is made, 
SYSGEN will prompt the legitimate answers, then repeat the question. 
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3.4 OPERATION 


In its operation, SYSGEN uses the answers provided by the user to 
perform a variety of tasks, including: 


1. Allocation of memory. 

2. Setup of the Job Table, System Queues, Partition Table, 
Device Table, UCI Table, and the Disk Storage Allocation 
Table. 


3. Allocation of buffer space for terminals, CPU-CPU devices and 
Mass storage devices. 


4. Setup of basic system hardware flags and status indicators. 


5. Transfer of all DEC-supplied library utility programs to the 
system UCI. 


In addition, SYSGEN builds and initializes a special system global 


called tsyYSs. This global is maintained by the Caretaker System 
Utility Program which uses it to log chronologically a variety of 
system status data. The Caretaker program is described in Section 


6.2.2. The tSYS global is described in Appendix F. 


3.5 PREOPERATIONAL INFORMATION 
The following paragraphs describe the detailed information that should 
be on hand prior to beginning a SYSGEN session. In general, the user 
should be thoroughly familiar with the hardware configuration to be 
used, particularly: 

1. Amount of memory available. 

2. Number and type of I/O devices. 

3. Type and number of disk systems. 

4. Number and size of partitions. 

5. Type and number of communications controllers. 

6. The highest device vector address used. 
Furthermore, the user should be sure that any user-written driver 
object modules for non-standard devices he intends to use (refer to 
Chapter 2) are included at System Build time. The user must also make 
certain that all disks to be used by MUMPS have been initialized with 
the MUMPS Backup and Utility System (see Appendix I). This system 


will take care of formatting the disk, checking for bad blocks, and 
setting up bit maps. 


3.5.1 Memory Size 
MUMPS-11 requires at least 24K words of memory and can use up to 124K 


words. Memory increases by a factor of 4K. For example, 24K, 32K, 
64K, etc. 
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3.5.2 Disk Memory 


There are four types of disk memory systems that can be used: 


Disk 
Type Disk System No. Drives 


0 RK11/RK03 or RKO5 disk pack (RK) 


© 


drives (maximum) 


1! RK611/RK06 cartridge disk (RM) 
RF11/RS11 fixed head disk (RF) 
RH11/RS04 fixed head disk (RS) 


drives (maximum) 
drives (maximum) 
drives (maximum) 


foe) [ooo ole eo) 


2 RP11-C/RP02 or RPO3 disk pack (RP) drives (maximum) 
3 RH11/RP04, RPO5 or RPO6 disk pack (RJ) 8 drives (maximum) 
2(4 RPO6 drives 
(maximum) ) 


MUMPS-11 uses any one or all types, with the exception that disk 
types 2 and 3 cannot be combined on the same system. At least one 
drive of the types listed above is required. When there is more 
than one type of disk system, a choice must be made as to which 
system is to be the system device. The system device is always 
drive 0 of the specified disk system (i.e., RKO, RFO, RSO, RMO, RPO, 
RJO). It contains: the memory image of the operating system, the 
global and program directories of the System UCI (UCI#1), and unless 
otherwise specified, the global and program directories for all 
other UCI's. 


3.5.3 Partitions 


A partition is required for each simultaneously logged-in terminal 
user and each STARTed program. Systems with less than 28K words can 
have up to 18 partitions, while systems greater than 28K words can 
have up to 40 partitions. The system has both standard and special 
size partitions. When a user logs in at a terminal, MUMPS-11 
allocates a standard size partition or, if that is unavailable, any 
special size partition greater than or equal to the standard size. 
Special size partitions allow the user to allocate memory 
efficiently. A user can START a program in a partition of a 
specified size. Partitions can also be tied to specific terminals, 
which will be described later. 


Partitions are allocated in increments of 128 memory words. 
Partition size can range from 128 words (minimum) to 4096 words 
(maximum). Size is specified by the number of 128-word increments. 
For example, 2 increments is a 256-word partition and 8 increments 
is 1024 words. At least one standard size partition must be 
specified and it should be at least 2K to allow the System Utility 
Programs to run. : 


Memory not used for partitions is automatically incorporated into 
256-word buffers, for use by mass storage devices. 


1. Only one of these three disk types (RM, RF or RS) may be used as 
disk type l. 


2. If RPO6 disk drives are used, one physical RP06 is treated as two 
logical RPO04 or 05 drives; therefore, you are limited to four RP06 
drives. 
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3.5.4 I/0 Devices 


The number and types of I/0 devices available, (including line 
printer, paper tape, card reader, DECtape, magtape, and special 
devices) must be determined. The controllers to which terminals are 
connected must be specifically identified. The console terminal is 
always assumed to be connected to either a KL11 or a DLI1I1A 
controller. Controllers for other terminals are grouped into four 
classes: 


pcll 
KL11 
DL11E, DL11W 


DMC11 


DH11 (16 terminal multiplexer) or 
DZ11 (8 terminal multiplexer) 


Determine the number of terminals in each class, not including the 
console terminal. The relationship between device numbers for 
terminals (device numbers 1, 4 - 19 and 64 - 111) and the various 
classes of controllers is shown below: 


1. Class 1 controllers, if any exist, are assigned the lowest 
device numbers (4 through 19). 


2. Class 2 controllers, if any exist, are assigned device 
numbers immediately following Class 1 controllers (up to 
device 19). 


3. Class 3 controllers, if any exist, are assigned device 
numbers immediately following Class 2 controllers (up to 
device 19). 


4. Class 4 controllers, if any exist, are assigned device 
numbers immediately following class 3 controllers (up to 
device 19). 


5. Class 5 controllers: 


Multiplexer No. 1, if a DH multiplexer is attached to 
devices 64 - 79 or if a DZ multiplexer is attached to 
devices 64 - 71. (1) 


Multiplexer No. 2, if a DH multiplexer is attached to 
devices 80 - 95 or if a DZ multiplexer is attached to 
devices 72 - 79.(1) 


Multiplexer No. 3, if a DH multiplexer is attached to 
devices 96 - 111 or if a DZ multiplexer is attached to 
devices 80 - 87.? 


1. The device number assignments for the DZ-11 multiplexer assume that 
no DH11's are assigned at the same time. For combined use of DH and 
DZ1ll's, see examples a and b under item 5 (class 5 controllers), and 
SYSGEN's multiplexer questions. 
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Extra Multiplexers Necessary If Using DZ's: 


Multiplexer No. 4 is attached to devices 88 - 95. 


Multiplexer No. 5 is attached to devices 96 - 103. 


Multiplexer No. 6 is attached to devices 104 - 111. 


Example: 


a. 


If a system has two DCll's, three DLII1A's, two DLIIE's, 
three terminals on a DH11 multiplexer and three terminals 
on a DZ11 multiplexer, assignments are: 


pcll 
Dcll 
DL11A 
DL11A 
DL11A 


DLLI1E 

DL11E 

DH11 MUX #1 
DH11 

DH11 

DZ11 MUX #2 
D211 

DZ11 


As the above example shows, when DH11 and DZ11 
multiplexers are combined, DH11's always get the lowest 
numbers. Because a DH11. multiplexer must have 16 devices 
assigned (even though only three are being utilized 
here), the DZ11 multiplexer (MUX # 2) is assigned to 
device number 80. 


If there are: no DCll's, KLll's, DLI11A's or DL11B's, 
three DLII1E's, one DH11 with four terminals, and two 
DZ11's with two terminals each, assignments are: 


DL11E 
DL1I1E 
DL11E 
DH11 MUX #1 


DH11 
DH11 
DH11 
D211 
D211 
D211 
D211 


Note that in the previous example, MUX # 2 is a DZ1l, and needs only 8 
device numbers (vs. 16 for DH11), so MUX # 3 must start at device 


number 88. 
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Each DCll-type controller has four selectable speeds (baud rates). 
Table 3-1 lists the various models of a DC1l controller along with the 
associated baud rates and speeds. 


Table 3-1 
DC1ll Baud Rates 


SPEED SETTING 


150 
1200 
1200 


(see note 1) 


1. Speed 3 on a DC11-AX is a customer-specified non-standard 
baud rate above 600 baud. 


NOTES 


A. If the user intends to use data sets, MUMPS assumes’ that 
they are connected to DLI1E controllers. These controllers 
are designed to interface to the BELL 103A Data Set. 


B. It is assumed that CPU-CPU devices are connected to DLI11A 
controllers (one for each line), and that the CPU's are 
local (i.e., hardwired). 


3.5.5 Directory Allocation 


Up to 16 UCI's can be designated. SYSGEN normally allocates directory 
space for programs and globals on the system disk. Storage area for 
programs and globals usually begins on the same disk unit as 
associated directories. As programs and globals increase in size and 
number, storage area will ultimately flow across disk unit and disk 
system physical boundaries. The user may locate the directories on 
any cylinder of any unit of any disk system. Or, he can choose not to 
allocate any directory areas for a UCI. This might be done to 
restrict the facilities available for programmer trainees. 
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3.5.6 Restricting Disk Storage Space For Programs And Globals 

SYSGEN also gives the user the capability of limiting program and 
global storage to specific disk units or disk systems. This feature, 
when used with the directory allocation options (described in Section 


3.5.5), is very useful in helping the system manager to allocate his 
disk storage areas for programs and globals. 


3.5.7 Device Interrupt Vector Locations 

Each I/O device is hardwired to a memory word location in low memory, 
usually below location 400 (octal). The MUMPS System Stack normally 
grows downward in memory until this limit is reached. Because vector 
Space may exceed this limit in large systems, the system manager must 


know the highest address used as a device vector, to allow SYSGEN_ to 
set the MUMPS internal limit register appropriately. 


3.6 STARTING PROCEDURE - MAGTAPE DISTRIBUTION 

The following paragraphs describe the steps to be performed to load 

and start SYSGEN with a tape distribution media. If the MUMPS Basic 

System is not running, refer to Section 2.6 for loading procedures. 
NOTE 


SYSGEN must be used only with the 
MUMPS-11 Basic System. 


Perform the following steps to load and start SYSGEN: 

1. Mount the SYSGEN tape on an appropriate tape drive. 

2. Set the tape transport controls for magtape (7-track: 
DEC-11-MMSYA-A-MB7 9-track: DEC-11-MMSYA-A-MB9), as follows: 
a. Remove the write enable ring from the tape reel. 
b. Position tape at LOAD POINT. 
c. Select drive number 0 through 3. 
d. Set ON LINE/OFF LINE switch to ON LINE. 


3. Begin MUMPS operation by logging in to the system at the 
console terminal as follows: 


as Type CTRL/C (depress CTRL key, then type aC), or press 
the BREAK key. MUMPS responds by typing: 


MUMPS-11 VO04B #1 
UCI: 


b. Immediately to the right of 'UCI:' type MGR (the system's 
default UCI code), followed by a colon (:), followed by 
the system's Programmer Access Code (PAC), which is: 
CTRL/X CTRL/X CTRL/X. (Depress the CTRL key and type X 
three times.) 
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UCI:MGR:CTRL/X CTRL/X CTRL/X~/ 


If no mistakes are made, MUMPS responds with its right 
caret (>) prompting symbol. If an error message is typed 
(SYNTX, etc.), repeat steps a. and b. (above) . If an 
‘at' symbol (@) is typed rather than a >, make sure all 
SWITCH REGISTER switches are in the OFF (down) position, 
then repeat steps a. andb. above. 


4. If a disk pack is to be the system device, mount a fresh pack 
on drive 0. Set the drive switches to: POWER ON, ON LINE 
and WRITE ENABLE. If other disk packs are to be used in the 
system being generated, they should also be installed on 
their drives at this time in the same way. 


Exception - If a SYSTEM MERGE is being performed, then the 
MUMPS data base packs should be mounted. 


NOTE 


Fresh packs must go through MBU initialization 
procedures, listed in Appendix I, prior to mounting 
and using. Fresh packs are only mounted on drives 
which are being added. 


5. To load and start SYSGEN, type the following command line for 
Magtape immediately to the right of the >: 


Aude Ves Pe 5 Le Del] ./ 


where: dev = 47 for magtape drive 
48 for magtape drive 
49 for magtape drive 
50 for magtape drive 
55 for DECtape drive 
56 for DECtape drive 
57 for DECtape drive 
58 for DECtape drive 


WNHrFROWNEHO 


When loading is complete, SYSGEN identifies itself and begins its 
interactive dialog with the user. 


3.7 STARTING PROCEDURE - RKO5, RKO6 DISTRIBUTION 


The following paragraphs describe the steps to be performed to load 
and start the MUMPS SYSGEN program with an RKO5 or RKO6 distribution 
media. If the MUMPS Basic System is not already running, refer to 
Section 2.7 for loading procedures. 


NOTE 


SYSGEN and SYSTEM MERGE must be used 
only with the MUMPS-11 Basic System. 
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1. Remove the MUMPS System Builder (MSB) cartridge, mount and 
load the MUMPS cartridge on drive 0, POWER ON, ON LINE, and 
WRITE ENABLE. If other disk packs are to be used in the 
system being generated, they should also be installed on 
their drives at this time in the same way. 


2. Begin MUMPS operation by lowering all switches and logging in 
to the system at the console terminal, as follows: 


a. Type CTRL/C (depress CTRL key, then type aC), or press 
the BREAK key. MUMPS responds by typing: 


MUMPS-11 V04B #1 
UCI: 


b. Immediately to the right of 'UCI:' type MGR (the system's 
default UCI code), followed by a colon (:), followed by 
the system's Programmer Access Code (PAC), which is: 
CTRL/X CTRL/X CTRL/X. (Depress the CTRL key and type X 
three times.) 


UCI:MGR:CTRL/X CTRL/X CTRL/X~/ 


MUMPS should respond with its right caret (>) prompting 
symbol. If an error message is typed (SYNTX, etc.), 
repeat step a. (above). If an ‘at' symbol (@) is typed 
rather than a >, make sure all SWITCH REGISTER switches 
are in the OFF (down) position, then repeat steps a. and 
b. above. 


3. To load and start SYSGEN, type the following command line 
immediately to the right of the >: 


>c sGl./ 


If no mistakes were made (see Section 3.8), SYSGEN identifies 
itself and begins its interactive dialogue with the user. 


3.8 ERROR CONDITIONS 


SYSGEN checks all user responses for correct syntax. When a= syntax 
error is detected, a message prompting the acceptable set of answers 
is typed and the question is repeated. SYSGEN does not detect logical 
errors such as specifying more memory than is available, or specifying 
that parity checking is desired when, in fact, it is not. 


If the user discovers an error before he types Carriage RETURN, it can 
be corrected by typing RUBOUTs to delete single characters or CTRL/U 
to delete the entire line. Errors that are found after typing 
Carriage RETURN ‘cannot be corrected in this way. If the error 
occurred in the answer to a question before the System Library 
Transfer Operation, MUMPS must be reloaded from the Basic System tape 
or disk (see Section 2.6.4 for magtape, Section 2.7.4 for disk) and a 
new SYSGEN session started. If the error occurred after the System 
Library Transfer Operation (see Section 3.9.5), it can be corrected by 
running the MSP System Utility Program (see Section 6.2.7) once SYSGEN 
has completed operation. 
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Another common error is not readying a disk device when requested. A 
fatal error occurs when the user responds that he has readied all 
devices as requested, but he actually has not. There is no recovery 
after this type of error; the system must be reloaded (see Section 
2.6.4 for magtape, Section 2.7.4 for disk) and the SYSGEN_ process 
begun again. 


The user should also never attempt to restart SYSGEN without reloading 
the Basic System. This is because SYSGEN alters memory locations that 
cannot be reset by doing an ERASE and KILL of the user's partition. 
The Basic System must always be reloaded when restarting a SYSGEN to 
ensure the integrity of the in-core MUMPS system. 


3.9 DETAILED DESCRIPTION OF OPERATION 


This section describes the options available to the SYSGEN user and 
explains some of the planning necessary for determining an optimum 
configuration for a particular installation. Each 3-digit paragraph 
denotes a new set of questions on a common subject area, and is 
accompanied by a figure showing typical user response. Each 4-digit 
paragraph presents an individual question and a description of its 
Meaning and use. Each answer, (Y for YES, and N for NO) must be 
terminated with a Carriage RETURN. 


3.9.1 Memory And Disk Memory Availability Questions 


This section defines the number of words-in memory and the number of 
physical disk drives of each disk system (see Figure 3-2). At least 
24K words of memory and one drive of one disk system type (RK, RF, RS, 
RM, RP, and RJ) must be specified. 


MUMFS-11 SYSTEM GENERATOR 
HOW MANY K CWORTS) OF MEMORY ARE THERE IN TOTAL? 124 
WILL THIS BE A SYSTEM MERGE? (CY OR ND)? ¥ 


PLEASE ANSWER DISK TYFE (RFs RSeRMe RR eRe RJ) OF PREVIOUS SYSTEM DISK? 
RM 


YOUR OLY! SYSTEM HAD 
O RK’Ss O RF’Ss O RS’Sy 1 RM’Sy O RF’S»s AND O RJ'S 


TYPE IN THE NUMBER OF X*kADDITIONAL Kk DISKS DESTRED FOR THE 
FOLLOWING ¢ 


RKLL’S CRN) 
RFIIS CRF) 
RSIS CRS) 
RKG611°S CRM) 
RPLI’S CRED 
RIJFO4sO05906°S (RID et 


19 ONE OF THE RKOS DRIVES A FIXED HEAD RKOSF? CY OR NG N 


SINCE RFO4’S, RFOS’S AND RPO46’S MAY BE MIXED, TYPE IN THE 
RFOS PHYSICAL DRIVE #°S» SEPARATED BY COMMAS? 


Figure 3-2 SYSGEN Session: Memory and Disk Memory Availability 
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HOW MANY K (WORDS) OF MEMORY ARE THERE IN TOTAL? nnn./ 


MUMPS uses from 24K to 124K of memory in 4K increments. Type a number 
(nnn) between 24 and 124 that is a multiple of 4. For example, 32, 
56, 104, etc. Specifies 32K words, 56K words, 104K words, etc. 


WILL THIS BE A SYSTEM MERGE (Y or N): Y./ 


If the user is building this system for the first time this question 
should be answered N. If the user already has a running MUMPS 
installation and simply wants to update the MUMPS operating 
system/interpreter with the new version, this question should be 
answered Y. 


NOTE 


If the distribution media is an RKO5 or 
RKO6, this question is not asked; Y is 
assumed since the RKOS5, RK06 
distribution always merges a new version 
of MUMPS into the MUMPS distribution 
system. 


Answering this question with Y allows a user to replace the operating 
system while retaining the programs and globals on the disk. AN 
response will clean the disk of all programs and data. 


A Y response (or an RKO5 or RKO6 distribution) results in a different 
set of questions to determine the disk configuration. These questions 
are illustrated for the RKO5 distribution in Figure 3-3. Note that 
the responses to the questions of number of additional disks should be 
the number of disks which are being added. If the distribution media 
is tape and the SYSTEM MERGE option has been selected, SYSGEN will 
ask: 


“PLEASE ANSWER DISK TYPE (RK,RF,RS,RM,RP,RJ) OF PREVIOUS SYSTEM 
DISK:", and the user should respond with either RK,RF,RS,RM,RP, or RJ. 


MUMPS-1d YO4k dl 
UCI? MGRE 
SC SG1 


MUMFS-11 SYSTEM GENERATOR 


HOW MANY K (WORDS) OF MEMORY ARE THERE IN TOTAL? 124 


YOUR OLY SYSTEM HAN 1 RR‘’S» O RF’S» O RS’°S» O RM’S» O RF’S»s AND O RIS 
TYPE IN THE NUMBER OF *xxADDITIONAL KKK DISKS DESIRED FOR THE FOLLOWING? 


RRIIL’S CRN) 

RFLI’S CRED 

RSL1’S CRS) 

RK61L1°S (CRM) 

RPLI’S CRP) 9 

RIP O42O05 9067S CRI) 20 
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NOTE 


Before running a SYSTEM MERGE, a 
physical copy of every disk pack used in 
the system should be made. This backup 
is extremely important. Do not proceed 
from this question if that backup has 
not been performed. 


HOW MANY DRIVES OF THE RK11 (RK) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RK11 disk system are allowed. Type a number (n) 
from 0 through 7. 


HOW MANY DRIVES OF THE RK611 (RM) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RK611 disk system are allowed. Type a number 
(n) from 0O through 7. If RK611 disks are being used, the following 
two questions (RF or RS) do not print out. This is because only one 
of the three disk types (RM, RF or RS) can be selected as disk type l 
(see Section 3.5.2). 


HOW MANY DRIVES OF THE RF1l (RF) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RF1l disk system are allowed. Type a number (n) 
from 0 through 7. 


HOW MANY DRIVES OF THE RH11 (RS) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RH11 disk system are allowed. Type a number (n) 
from 0 through 7. 


HOW MANY DRIVES OF THE RP11 (RP) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RP11l disk system are allowed. Type a number (n) 
from 0 through 7. 


HOW MANY DRIVES OF THE RH11 (RJ) SYSTEM ARE THERE? n_/ 


Up to 8 drives of the RH11 disk system are allowed. Type a number (n) 
from 0 through 7. 


SINCE RP02's AND RPO3's MAY BE MIXED, TYPE IN THE RPO2 DRIVE 


#'S, SEPARATED BY COMMAS: n_7 


If this system has RP drives, SYSGEN asks this question to determine 
which RP disk drives are RP02's and which are RPO3's. Enter the unit 
number (n) of each RP02 disk drive in the system. Separate each entry 
with a comma (e.g., n,n,n). If there are no RPO2 disk drives, type a 
Carriage RETURN. 


' 


SINCE RP04'S, RPO5'S AND RP06'S MAY BE MIXED, TYPE IN THE RPO6 DRIVE 
#'S SEPARATED BY COMMAS: n_/ 


If this system has RP drives, SYSGEN asks this question to determine 
which RP disk drives are RP04's and RPO5's and which are RP06's. One 
physical RP06 is treated as two logical RP04's or RPO5's, as far as 
MUMPS is concerned. Enter the unit number(n) of each RP06 disk drive 
in the system. Separate each entry with a comma (e.g., n,n,n). If 
there are no RPO6 disk drives, type a Carriage RETURN. 
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RK 

WHICH TYPE OF DISK SYSTEM IS THE SYSTEM DEVICE? |RF,RS or RM Pe 
; RP 
RJ 


SYSGEN asks this question when there is more than one type of disk 
system specified. Drive 0 of the selected system is always the system 
device. 


3.9.2 I/O Device Availability Questions 


This section asks questions about the existence of I/O devices (Figure 
3-4). SYSGEN types the first two columns of a 3-column tabular 
listing. The first column contains the device number(s), the second 
column the device name and the third column the user's yes(Y) or no 
(N) response. Since device numbers 1, 20-45, 46 and 63 must always 
exist, SYSGEN itself answers Y for these devices. Therefore, the 
paragraphs that follow do not deal with them. 


Device numbers 1, 4-19 are available for terminal-type devices that 
operate with the various models of DEC's single line communications 
controllers (DCl1, DL11, KL11 or DMC11). Up to 16 devices can be 
specified (see Section 3.5.4). As the user responds to the questions 
concerning these devices, SYSGEN types out the device numbers’ that 
remain for assignment. Sixteen words of memory are allocated for each 
device (1-19, 64-111) specified. 


DEVICE # KEVICE TYPE Y OR N 


CONSOLE 
FAPER TAPE 
LINE FRINTER 
An? neta ’s 
4-19 KLIS DLA’ Ss DL1IB’S 
4-19 Nha 7S¢C THRU ED 
4-19 NON-STU. TERM. (E.G. 22N0 LP) 
20-45 FROGRAM INTERLOCKS 
VIEW MEMORY ONLY DEVICE 
MAG TAFES 
RESERVED TEVICES 
NEC TAFES 
SEQUENTIAL ISK FROC‘’S 
VIEW DISK OR MEM. DEVICE 
TH-11 MULTIPLEXER #41 
2-1 MULTIPLEXER #1 
IN CORE JO8 COMMUNICATION 


TIUIG? Y 


<2Z<x<«<<z«<x<xz2z2z22z2~<z~< 


Figure 3-4 SYSGEN Session: I/O Device Availability 


2 PAPER TAPE | Y 


ni? 


If paper tape reader/punch exists, type Y; otherwise type N. 
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Y 
N 


3. LINE PRINTER 
—— _ 


If line printer exists, type Y; otherwise type N. 


4-19 DCll1's 


Y 

Be 

If one or more terminals use DCll controllers, type Y; otherwise type 

N. If the answer is Y, SYSGEN asks for the quantity to be specified: 
TYPE 0 - 16: nn_/ 


Type a number (nn) from 0 through 16. AO answer causes SYSGEN to 
skip to the next question. 


Y 


m-19 KL11'S,DL11'S,DL11B'S 
N 


~~ 


SYSGEN types the remaining device numbers(m) to be used (m-19). If 
the answer is Y, SYSGEN asks for the quantity to be specified: 


TYPE 0 - t: nn _/ 


Type a number (nn). from 0 through t (t = total device numbers 
remaining). A 0 answer causes SYSGEN to skip to the next question. 


m-19 DL11'S(C THRU E) 


Y 

Ee 

SYSGEN types the remaining device numbers(m) that can be used (m-19). 
If the answer is Y, SYSGEN asks for the quantity that can be 
specified: ; 


TYPE 0 - t: nn_/ 


Type a number (nn) from 0 through t (t = total device numbers 
remaining). A 0 answer causes SYSGEN to skip to the next question. 


m-19 DMC11'S x 
N 


pe 


SYSGEN types the remaining device numbers (M) that can be used (M-19). 
If the answer is Y, SYSGEN asks for the quantity to be specified: 


TYPE O-t: nn. 


Type a number (nn) from 0 through t (t = total device numbers 
remaining). A 0 answer causes SYSGEN to skip to the next question. 


m-19 NON-STD. TERM. (E.G.2ND LP) k Ls 


N 


SYSGEN types the remaining device numbers(m) that can be used (m - 
19). Non-standard terminal type devices are devices that can be 


SYSTEM GENERATION PROCEDURES 


connected to standard DEC single line controllers (DL11,KL11 or DCll). 
Two examples of non-standard devices are: an additional line printer, 
and RTO2 data entry terminal. 


If devices of this type are to be used, in addition to answering Y to 
this question, the user must also connect the devices' interrupt 
vectors and I/O registers to the MUMPS terminal I/O driver as 
described in Appendix H. 


If there are no devices of this type, type N. If the answer is Y, 
SYSGEN types: 


TYPE 0 - t: nn. 


Type in the number (nn) of non-standard terminal devices in the range 
0 through t (t = total device numbers remaining). 


a 


47-50 MAGTAPES E 
N 


If there are one or more magtape drives in the system, type Y; 
otherwise type N. If the answer is Y, SYSGEN types: TJU16? If the 
system will use TJU16 drives, type Y; otherwise type N. 


~? 


51-54 RESERVED DEVICES F 
N 


A reserved device is any standard or non-standard I/0 device 
controller and associated device driver combination. Examples of such 
devices are: card readers, magnetic tape drives (not manufactured by 
DEC), DECcassettes, etc. If devices of this sort are to be used, the 
appropriate device driver modules must have been previously designed 
by the user (see MUMPS-11 Programmer's Guide) and incorporated into 
the MUMPS Basic System at system build time (see Section 2.3.2), 
before answering Y to this question. If the answer is Y, SYSGEN types 
out the following reminder to this effect: 


IS YOUR OWN MODULE LINKED? 


If the user has not done this, he must terminate SYSGEN operation and 
link his driver module(s) into the system, as described in Appendix I 
of the MUMPS-11 Programmer's Guide. Once this is accomplished, a new 
SYSGEN session can be initiated. 


55-58 DECTAPES | Y 
eae 


N 


If there are one or more DECtape drives in the system, type Y; 
otherwise type N. 


59-62 SEQUENTIAL DISK PROC'S | Y 
N ~ 


The Sequential Disk Processor (SDP) device is a feature of MUMPS-11 
that allows for non-standard sequential type file structuring on 
specified areas of the disks in the system (see MUMPS-1ll Programmer's 
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Guide). If this feature is desired, in addition to typing Y, the user 
must have already incorporated the SDP module into the Basic System 
(see Section 2.8). If no SDP is wanted, type N. To actually reserve 
disk space for the SDP, the user must run the SDP System Utility 
Program (Chapter 6) once the new system is operational. 


64-79 DH-11 MULTIPLEXER#1 5 

a ee Ig 

MUMPS-11 allows for the installation of up to three DH-1l1 or up to six 
DZ-11 multiplexers, each of which may have up to 16 local terminals 
attached. If a multiplexer exists in the hardware configuration, type 
Y. In addition, the user must have previously incorporated the 


multiplexer module into the Basic System (see Section 2.8). If no 
Multiplexer is present, type N. 


80-95 DH-11 MULTIPLEXER #2 


Y 
n |<’ 


If the response to the previous question was Y, this question is asked 
to determine the presence of a second multiplexer. If a second DH11 
is included in the hardware configuration, type Y; otherwise type N. 


96-111 DH-11 MULTIPLEXER #3 |Y 
N ~/ 


If a third DH-11l is not included, type N and the following set of 
questions will be asked. 


64-71 DZ-11 MULTIPLEXER #1 |Y 


ae 


This question is typed only if less than three DH-ll's were’ selected. 
If only one DH-11 was selected previously, up to four DZ-11's can now 
be added; if two DH-11's were selected previously, up to two DZ-ll's 
can now be added. 


Y 
N 


72-79 DZ-11 MULTIPLEXER #2 oe 


This is only asked if the answer to "64-71 DZ-11 MULTIPLEXER #1" was 
mys If only one DH-11 was selected previously, up to three more 
DZ-1l's can now be added; if two DH-ll's were selected previously, 
only one more DZ-11 can now be added. 


Depending on the user's answers to the previous DH-1ll and Dz-1l 
questions, one of the questions in each set below will be asked. 


80-87 DZ-11 MULTIPLEXER #1 
OR 
80-87 DZ-11 MULTIPLEXER #3 
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88-95 DZ-11 MULTIPLEXER #2 
OR 
88-95 DZ-1l1 MULTIPLEXER #4 


96-103 DZ-11 MULTIPLEXER #1 
OR 

96-103 DZ-11 MULTIPLEXER #3 
OR 

96-103 DZ-11 MULTIPLEXER #5 


104-111 DZ-11 MULTIPLEXER #2 
OR 

104-111 DZ-11 MULTIPLEXER #4 
OR 

104-111 D2Z-11 MULTIPLEXER #6 


112-127 JOB COMMUNICATION |Y 


ni|~ 


Job communication allows jobs to pass information to each other 
through pseudo devices. If this module has been incorporated in the 
Basic System, type Y; otherwise type N. 


3.9.3 Device Buffer Allocation Questions 


This section (see Figure 3-5) contains questions that deal with the 
allocation of memory buffer space for the various I/O devices and the 
disk memory system as established by questions covered in Sections 
3.9.1 and 3.9.2. 


HOW MANY 32 WORD RING BUFFERS [10 YOU WANT? 6 
WILL YOU HAVE CFU-CFU DEVICES? N 
HOW MANY 256 WORK BUFFERS 00 YOU WANT? 4 


THERE ARE 32 DISK BUFFERS AVAILABLE. HOW MANY [O YOU WISH TO INCLUDE? 
TYFE O THRU 32% 32 


THERE ARE 97K WORDS LEFT FOR PARTITIONS. IS THIS SUFFICIENT? 
(TYPE Y OR NDS Y 


Figure 3-5 SYSGEN Session: Device Buffer Allocation 


HOW MANY 32 WORD RING BUFFERS DO YOU WANT? nn —/ 


All terminal type devices (device numbers 1, 4 - 19, and 64 - 111) 
utilize buffers on a shared, first come, first served basis. These 
buffers, called ring buffers, require 32 words of memory each. Job 
communication does not use these ring buffers. 
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The number of 32-word ring buffers is determined by the total number 
of terminals that are to be simultaneously active (ASSIGNed) in the 
new system, including paper tape and line printer. Type a number 
between 1 and 64. 


Y 
N 


WILL YOU HAVE CPU-CPU DEVICES? ee 


This question does not print out unless CPU-CPU devices were selected 
in the previous (I/O Device Availability) section. CPU-CPU devices, 
although serviced by MUMPS as terminal devices (device numbers 1,4 - 
19 and 64-111), do not share buffers with the other devices. Each 
device is assigned a single 44-word buffer for its own use. These 
devices are assumed to be DLIIE controllers, each of which is directly 
connected (hardwired) to another central processor. 


If there are one or more CPU-CPU devices in the system, type Y; 
otherwise, type N. If the response is Y, SYSGEN types: 


HOW MANY 44 WORD BUFFERS? nn _/ 


Enter the number (nn) of 44-word buffers - one for each device (0 - 
16). If 0 is typed, SYSGEN allocates none and skips to the next 
question. 


ae 


WILL YOU BE USING DMC-11 COMMUNICATION CONTROLLERS? E 
N 


This question does not print out unless DMC-11 Controllers were 
selected in the previous (I/O Device Availability) section. If you 
are using one or more DMC-11 communication controllers, type Y; 
otherwise, type N. 


HOW MANY 256 WORD BUFFERS DO YOU WANT? nn_/ 


Mass storage type devices include DECtape (device numbers 55-58), 
Magtape (device numbers 47-50), Sequential Disk Processor (device 
numbers 59-62), and the VIEW Disk or Memory Device (device number 63). 
Each of these devices uses a single 256-word buffer when operating. 


Buffers which are not being used reside in a common pool and are 
allocated to mass storage devices as needed. A job which requests a 
buffer when none are available will hang until a buffer becomes 
available. Enter the number (nn) of 256-word mass storage device 
buffers desired. For example, if there are two DECtape drives and one 
Magtape drive, four buffers may be desired, or perhaps as few as two. 
(The VIEW command uses a buffer.) At least one buffer should always be 
allocated to enable system programs to use the VIEW command. 


THERE ARE 32 DISK BUFFERS AVAILABLE. HOW MANY YO 
WISH TO INCLUDE? TYPE 0 THROUGH 32: nn _/ 


The Basic MUMPS-11 System contains two 256-word buffers that are used 
for all disk I/O operations. Most significantly, these buffers are 
used to store disk blocks of global data. As the number of 
concurrently active globals in a system increases, the average global 
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access response time will also increase unless the number of disk 
buffers in the system is increased. This is because fewer logical 
disk accesses can be made before a physical disk access is required to 
service another global. Up to 32 additional disk buffers can be 
specified to reduce global access time. Enter the number (nn) of 
256-word buffers desired. SYSGEN then responds: 


THERE ARE nn. nnKk WORDS LEFT FOR PARTITIONS. IS THIS 

SUFFICIENT? 

TYPE Y OR N: 
n|~ 


If the number of words of memory remaining after buffer allocation 
(nn.nnK) is sufficient, type a Y to continue; otherwise, type an N to 
return to the previous question. 


3.9.4 Partition Allocation Questions 


This section deals with questions about the allocation of memory for 
both standard and non-standard size partitions (see Section 3.5.3 and 
Figure 3-6). At least one standard partition must be allocated. A 
maximum of 18 partitions, for systems with less than 28K of memory, or 
40 partitions, for systems with more than 28K of memory, can be 
allocated. Partition size is specified in terms of the number of 
128-word increments desired. Table 3-2, following, shows partition 
size in 128-word increments versus partition size (words). Though any 
size can be specified from 1 (128 words) to 32 (4096 words), a highly 
recommended size for standard partitions is 16 (2048 words). This 
allows operation of the DEC-supplied System Library Programs, and it 
is a good general size for MUMPS applications programs. In addition, 
it is recommended that a 0.75K-word partition be allocated for use by 
the System Caretaker program (CTK), described in Section 6.2.2. At 
the completion of this section, SYSGEN allocates unused memory as 
256-word buffers. 


AVATLABLE PARTITION SFACE = 97K 
FARTITION SIZES ARE IN 128 WORD INCREMENTS (E+G.rik=8 INC.) 


WHAT IS THE STANDARD FARTITION SIZE? 32 (4K) 
HOW MANY STANDARD FARTITIONS? 6 (73K LEFT) 


TYPE IN ALL ALNITIONAL FARTITION SIZES ANID THE NUMBER REQUIRED FOR EACH. 
TERMINATE THE LIST WITH A =CRo. 


PARTITION SIZE NUMBER 
& €0.75K) L (72.256 LEFT) 


Figure 3-6 SYSGEN Session: Partition Allocation 
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Table 3-2 
Partition Sizes 


128-word Size 
Increments (words) 


1 
2 
3 
4 
5 
6 
7 
8 
9 


SYSGEN begins this section by informing the user of the amount of 
memory (nnK) available for partitions: 


AVAILABLE PARTITION SPACE = nnK 
followed by the message: 


PARTITION SIZES ARE IN 128 WORD INCREMENTS (E.G., 1K = 8 INC.) 


WHAT IS THE STANDARD PARTITION SIZE? nn _/ 


Enter a number which is between 1 and 32 (see Table 3-2). SYSGEN 
types the partition's size to the right of the answer. 


HOW MANY STANDARD PARTITIONS? nn_/ 


Enter a number (nn) between 1 and m, where m is the result of dividing 
the amount of memory available for partitions by the standard 
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partition size (in words). If the user types an answer that would 
cause allocation of more memory than is available, SYSGEN types: 


nnK SPACE EXCEEDED. 
and allows the user to try again. 


Immediately to the right of the user's answer, SYSGEN types the amount 
of memory remaining for non-standard size partition allocation. 
Before typing the next question and if there is any memory’ space 
remaining, SYSGEN types: 


TYPE IN ALL ADDITIONAL PARTITION SIZES AND THE NUMBER 
REQUIRED FOR EACH. TERMINATE THE LIST WITH A <CR>. 


PARTITION SIZE NUMBER 


SYSGEN types the column headings shown above. Under each heading the 
user can enter the sizes of non-standard partitions. Typing a 
Carriage RETURN (only) terminates the list. SYSGEN types out the 
amount of memory remaining to the right of each entry in the NUMBER 
column. 


3.9.5 Disk Inclusion and System Library Transfer 


At this point SYSGEN is about to include all disk devices in the 
system and, unless the distribution media is RKO0O5 or RKO6, 
subsequently transfer the System Library Programs from the SYSGEN tape 
to the system disk. In so doing, it enters the name of each program 
in the program directory of UCI No. 1 (system manager's UCI). To 
this end, SYSGEN types out the following message: 


FREPARE FOR DISK INCLUSION, 

READY ALL DLSKS (MOUNT FORMATTED, INITIALIZED PACKS» WRITE ENABLED: 
ETC.) 

WHEN ALL ARE READY, TYPE <CR>. 


Before typing Carriage RETURN, the user must: 


1. Mount all disk packs that were specified as being in this 
system. (These packs must have been previously formatted for 
PDP-11 use, and initialized by the MUMPS Backup and Utility 
System described in Appendix I.) 


2. Set all appropriate disk drive function switches to: POWER 
ON, ON LINE, WRITE ENABLE (or WRITE PROTECT OFF). 


Once Carriage RETURN is typed, SYSGEN proceeds with disk inclusion 
procedures. SYSGEN checks each disk to be sure that it has been 
initialized by the MUMPS Backup and Utility System. This system 
performs bad block checking and creates the MUMPS bits maps. If any 
disk has not been initialized, SYSGEN will abort. 


Upon completion, the following question is asked (unless the 
distribution media is the RKO5 or RKO6): 


DO YOU WANT THE EDITOR TO BE LOADED TO 1%? Be 
N 
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if the Editor (see Chapter 4 of the MUMPS-11 Programmer's Guide) is to 
be inserted into the t% global, type Y. The following message is then 
output. 


THE SYSTEM LIBRARY WILL NOW BE TRANSFERRED TO THE SYSTEM DISK. 


SYSGEN types out the name of each program transferred. 


NOTE 


This terminates the operation of SYSGEN 
proper. SYSGEN now transfers control to 
the Modify System Parameters program 
(MSP) to continue the system generation 
process. Logical errors that occur in 
answering the questions which follow can 
be corrected by running MSP after the 
current session has been completed. 


3.9.6 Modify System UCI's and PAC Questions 


The questions in this section (see Figure 3-7) deal with the current 
User Class Identifier (UCI) codes, the Programmer Access Code (PAC), 
and new UCI codes. A user can alter the current UCI or PAC, and 
specify new UCI codes. In addition, the user can specify: the actual 
disk cylinder for the program/global directory area of each UCI, that 
no directory be allocated at all, or that MSP allocate space for the 
directories. In the last case, MSP will allocate directories on the 
system disk. Up to 16 UCI's can be specified. 


The dialog in this section is in tabular form. The user enters 
responses in a left-to-right, column-by-column manner. MSP enters the 
UCI's that currently exist in the system in the OLD UCI column. If 
there are none, the column entry is NULL. The paragraphs that follow 
describe the responses that the user can make in the remaining two 
columns. 


MODIFY SYSTEM UCI’S AND FAC 
UCT# OLD UCT NEW UCT QIRECTORY 


MGR MGR CRMOZL 20972460) 
MYA MYA CRMOZ1L4 20980746) 
LF LF CRMOZSO 2100452) 
CWA CWA CRMOF200 2110352) 
JRF ARE CRMO2300 2114992) 
GSK GSK CRMOZI4A 2098078) 
DHG DHG CRMOS407 2124014) 
NULL 


1 
2 
3 
4 
a 
6 
? 
8 


WHAT SHALL THE FAC BE? 


Figure 3-7 SYSGEN Session: Modify UCI's and PAC 
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NEW UCI 


Under this column, the user can replace the current UCI by typing a 
new UCI name or, if NULL, enter a new UCI name. UCI names must be 
three characters long. The'first character must be either alphabetic 
or the % symbol. In addition, the following alternative responses 
(underlined) can be typed. 


Carriage RETURN to retain the old UCI/directory status and 
continue the listing sequence. 


N (Carriage RETURN) to retain the old UCI, without allocating 
any directory, and continue the listing sequence. 


Any of the above responses following a NULL UCI entry terminates the 
listing sequence and causes MSP to skip the next question. 


DIRECTORY 


Under this column, the user can specify the existence and location of 
user program and global directory storage for each UCI. Ifa 
directory is allocated, MSP types the directory's location to the 
right of the user's last response in the parenthetical form: 


(dkn:c b) 


where: dkn = Disk device mnemonic and unit number 
(e.g., RK2, RF6, RPO, RJ3, etc.) 


RS4 or 

RM1 
c = Disk unit cylinder number 
b = MUMPS block number 


The user can type one of the following responses (underlined) : 


Carriage RETURN to request MSP to allocate a directory on the 
system disk. 


N (Carriage RETURN) to prevent directory allocation but 
continue the listing sequence. 


RKn:c(Carriage RETURN) to allocate the directory on RK11 disk 
unit n (0 - 7), cylinder number c (0 - 199) 


RFn or (Carriage RETURN) to allocate the directory on RF or 
RS 
RSn disk unit n (0 - 7) 


RMn:c(Carriage RETURN) to allocate the directory on RKO6 disk 
unit n(0-7), cylinder number c(0-407) 


RPn:c(Carriage RETURN) to allocate the directory on RP11l disk 
unit n (0 - 7), cylinder number c (0 - 199 for RPO2 or 0 - 
399 for RPO3) 


RJn:c(Carriage RETURN) to allocate the directory on RH11 disk 
unit n (0 - 7), cylinder number c (0 - 407) 
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MSP continues the listing sequence, unless prematurely terminated by 
the user, until 16 UCI's have been specified. MSP then proceeds to 
the next question in the series. 


WHAT SHALL THE PAC BE? 


XXX 

mx | 

The Programmer Access Code (PAC) allows a user to operate at a MUMPS 
terminal in Direct Mode, The PAC can be any three printing or 
non-printing characters in the MUMPS character set except CTRL/C, 
CTRL/O and CTRL/U. To retain the current PAC, type Carriage RETURN. 
To create a new PAC, type in the new PAC (xxx) followed by a Carriage 
RETURN. 


3.9.7 Modify Terminal Device Parameters Questions 


Proper responses to the questions in this section (see Figure 3-8) 
allow the user to establish and modify operating parameters for 
terminal type devices (1, 4 - 19 and 64 - 111). The dialog is in a 
table format consisting of nine columns. The user enters responses in 
a left-to-right, column-by-column manner. 


MODIFY TERMINAL DEVICE PARAMETERS 


FART UCI FGM TATA STALL OUTPUT 
SIZE NO. NAM VTXX SET UMC-11 COUNT ONLY 


FARITY (CY OR ND? Y 
0S 
50 
HALF or FULL DUPLEXCH or FO? 
FRIMARY OR SECONDARY 
STATION (F or S)?C(1) 
SPEED (0-3)? 3 


Figure 3-8 SYSGEN Session: Modify Terminal Device Parameters 


Default values for each parameter (Basic System) are as follows: 
The terminal is not tied to a partition, program or UCI. 
The terminal is a hard-copy device. 
The terminal is not a CPU-CPU device. 
The terminal is not connected to a data set (the appropriate 
modules must be linked into the Basic System at system build 


time. See Chapter 2). 


The stall count (number of filler characters) is 0. 


1. This question only prints out if the previous question is answered 
H. 
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The terminal has both input and output capabilities. 
Papertape parity generation and checking are not performed. 


DCll controllers are set to the lowest speed (see Table 3-1). 


Enter the number of the terminal (nn) for which parameter change is 
desired. The number must be in the range 1,4 - 19 or 64 - 111. To 
terminate the listing sequence, type Carriage RETURN. MSP skips’ to 
the next set of questions (see Section 3.9.8). 


nn 

ae 

If the terminal is to be tied to a specific size partition (i.e., tied 
terminal), enter the size (nn). A terminal that is not tied to a 
partition is allocated a standard partition or larger (if necessary) 
at log-in time. Note that the size must be one that was specified 
under the questions covered in Section 3.9.4. If the terminal is not 
to be tied, type Carriage RETURN. 


A proper response to this question allows a terminal to be tied to a 
particular User Class Identifier code (UCI). When a terminal is tied 
to a UCI it must be tied to a program also (see comments under 
following question entitled PGM NAM). This restricts the user to 
programs and globals residing in the program and global directories 
associated with that UCI; log in via other UCI's is not allowed. To 
tie the terminal to a UCI, enter the UCI's number (nn). The UCI 
number is determined by its place in the order of UCI's entered. The 
System UCI is UCI number 1, the fifteenth UCI code entered is UCI 
number 15, etc. If a UCI number is specified, MSP advances to the 
next column. If a terminal is not to be tied to a UCI, type Carriage 
RETURN (MSP skips the next column). To untie a terminal that has 
previously been tied, type a space when MSP asks for the UCI number, 
and another space when MSP asks for the program name. If only a 
Carriage RETURN is hit, MSP assumes that no changes will be made to 
the modified terminal. 


PGM 

NAM 

XXX—/ 

oe 

A proper response to this question allows the user to tie a terminal 
to a specific program (xxx). MSP expects an answer in this column 
only if a UCI was specified in the previous question. When a terminal 
is tied to a program, only that program is available to users of that 
terminal. Program operation begins when a user types CTRL/C or 
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presses the BREAK key. To tie the terminal to a program, enter the 
program's name. Otherwise type Carriage RETURN to skip to the next 
column. If the terminal is already tied to a UCI, an answer to this 
question is required. 


If the terminal is a VT05 video terminal, type 05; if it ais vmT50, 
type 50; if it is a vT52, type 52; if it is a vT55, type 55; 
otherwise, type Carriage RETURN. 


CPU 

ea 

a 

This question will only print out if CPU-CPU devices were selected in 
the I/O Device Availability section. The CPU-CPU device is used for 
local (hardwired) interprocessor communication. Only DL1I1A 
controllers can be used this way. Therefore, the user should be sure 
that the terminal specified is connected to a DLI11A_ controller. If 
the terminal is to be a CPU-CPU device, type a Y; otherwise, type a 
Carriage RETURN. Once a terminal is set up to be a CPU-CPU device, it 


cannot be changed via MSP; instead, the user must system-generate a 
new system. 


DMC-11 
Y. 


This question will only print out if DMC-11 controllers were selected 
in the I/O Device Availability section. The DMC-11 communications 
controller is used for local or remote interconnection of PDP-1ll 
computers in network applications. If one or more DMC-1l's are to be 
used, type a Y; otherwise, type a Carriage RETURN. 


DATA 

SET 

eal 

a7 

If the terminal is to interface to a BELL type 103A Dataset (supported 


by the DLI11-E, DH11 or DzZll interfaces), type Y; otherwise type 
Carriage RETURN. 


= 
= 


When terminals operate at data rates of 300 baud or greater, certain 
of their functions such as Carriage RETURN, FORM Feed and LINE FEED 
cannot be performed within the interval allotted to the other 
characters and functions. This can cause character displacement or 


3-27 


SYSTEM GENERATION PROCEDURES 


total loss for characters that immediately follow one of these 
functions. To prevent this from happening, MUMPS can wait a specified 
number of character times after one of these functions before sending 
out the next character. This is accomplished simply by sending out a 
number of non-printing RUBOUT character codes (octal code 177). The 
number of RUBOUTS is specified by the stall count value. 


Stall counts for applicable DEC terminals are: 


Serial LA30 (300 baud) = 10 
LA36 (300 baud) = 10 
vT05 (300 baud) = 1 
vT05 (600 baud) = 4 
VTO05 (1200 baud) = 8 
VT05 (2400 baud) = 20 


If the device is to operate at 300 baud or greater, enter the stall 
count (nn). Some of the newer devices, such as the VT50, VT52 and 
VT55 Video Terminals, have zero stall counts. In these cases, type a 
Carriage RETURN to advance to the next column. 


OUTPUT 
arse 
Y. 
Brey, 
If the device is to be used for output only, (e.g., a second line 
printer or an RTO1) type Y; otherwise type Carriage RETURN. 


PARITY (Y OR N)? /Y 


N 


~/ 


A proper response to this question allows the user to enable or 
disable parity generation for paper tape I/O. Even parity is 
generated on output and validated during input. This question is 
asked only when device number 2 is specified in TRN NO. column. The 
question is typed to the right of the "output only" column. If parity 
is desired, type Y; otherwise type N. 


' SPEED (0 - 3)? n./ 


A proper response to this question allows the user to set the speed 
(baud rate) of the various models of DCll controllers. The 
relationship between the speed value (0 - 3) and the actual baud rate 
is shown in Table 3-1 in the beginning of the Chapter. This question 
is output only when a device number that is associated with a DCll 
(see Section 3.9.2) is specified in the TRM NO. column. Enter a 
number (n) between 0 and 3. 


3.9.8 Multiplexer Terminal Line Conditioning Questions 


This section (see Figure 3-9) allows the user to establish and modify 
operating parameters for terminals (devices 64-111) connected to DH11 
or DZ11 multiplexers. These questions are asked only if a multiplexer 
was specified (see Section 3.9.2). The information obtained in these 
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questions is in addition to that covered in Section 3.9.7, 
specifically: 


address(es) of the multiplexer status register(s) and 
interrupt vector 


whether parity operation and checking are to be performed 
I/O line speed (baud rate) 


The address questions appear only when MSP is running under’ the 
control of SYSGEN. The remaining questions request that terminal 
operating parameters be specified. The dialog for this question is in 
table format consisting of four columns. Responses are entered ina 
left-to-right, column-by-column manner. 


MUX TERM PARITY RECVR XMITTR 
(E OR O) SPEED SPEED 

110 110 

9400 9600 


9600 94600 
94600 9600 
2400 2400 
2400 2400 
110 110 


Figure 3-9 SYSGEN Session: Multiplexer Terminal Line Conditioning 


Default values for each parameter (Basic System) are as follows: 
1. The terminal has no parity checking 


2. The terminal is not connected to the system (i.e., RECVR 
SPEED = 0, XMITTR SPEED = 0) 


Note that the multiplexer must be specified as being part of the Basic 
System at system build time (see Section 2.7). 


MULTIPLEXER n VECTOR ASSIGNED STARTING AT aaa(OCTAL) 


IS THIS ADDRESS CORRECT? | Y 
$e TEES ADDRESS CORRECT? | I 


The interrupt vectors for DH1l's and DZ-11's are normally connected to 
standard locations in low memory reserved for this purpose, and SYSGEN 
assumes that this is the case. However, in cases where there are very 
large non-standard hardware configurations, an exception to this rule 
May exist. When this message is output, the n specifies the 
multiplexer number (1, 2, 3, 4, 5 or 6), and aaa specifies the address 
(octal) of the first word of the multiplexer interrupt vector area. 
This address is the first vector following the last vector used by the 
last DC1ll, KL11 or DL11 specified (see Section 3.9.2). Vectors are 
assigned contiguously beginning at address 300 (octal). If this 
address is correct, type Y; otherwise, type N. If N is typed, SYSGEN 
asks for the correct vector address, as in the following example: 


MULTIPLEXER 1 VECTOR ASSIGNED STARTING AT 000310 (OCTAL) 
IS THIS ADDRESS CORRECT? N 
TYPE IN CORRECT VECTOR ADDRESS IN OCTAL (#<500): 320 


TYPE IN THE OCTAL ADDRESS OF MUXn STATUS REGISTER: aaaaaa/ 
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Each DH11 or DZ11 multiplexer has a status regi ‘er in the PDP-ll's 
external memory page. There are no bs hdard addresses for these 
registers, therefore the user must obtain-this information from his 
DIGITAL field service representative. 


Enter the address aaaaaa of the status register of multiplexer n (1 or 
2). The address must be in the range: 160000<aaaaaa<177774. 


TYPE IN OCTAL ADDRESS OF MUX1 STATUS REGISTER (#>160000): 160040 


MUX TERM 

NO. 

Ed 

at 

If a parameter change is required for a specific terminal, enter the 
number of the terminal (nn). The number must be in the range 64-79 if 
one DH11 exists, 64-95 if two exist, 64-111 if three exits; or, 64-71 
if one DZ1l exists, 64-79 if two DZ11 exist, 64-78 if three exist, 
64-95 if four exist, 64-103 if five exist, or 64-111 if six exist. 
Note that if DH and DZ multiplexers are combined, DH multiplexers will 
be assigned the lowest numbers. To terminate the listing sequence, 
type Carriage RETURN to cause MSP to skip to the next set of 
questions. 


PARITY 
E 
lol-/ 


A proper response to this question allows the user to select I/0 
parity generation and checking for the terminal. Type an E if even 
parity is desired, or O if odd parity is desired, or a Carriage RETURN 
if no parity checking is desired. 


RECVR 

SPEED 

nnn_/ 
Enter a number (nnn) that is the baud rate for input from the 
specified terminal. The acceptable inputs are listed in Table 3-3 


below. A baud rate of 0 effectively disconnects a terminal's receiver 
from the Multiplexer and is a method of disabling currently 
nonexistent or broken terminals. 


XMITTR 
SPEED 
nnn_/ 


Certain terminals (e.g., VT05, serial LA30) allow selectable speeds 
and some (e.g., VT05) allow split input/output speeds. This question 
allows the user to specify the Baud rate for output to the specified 
terminal. Acceptable responses are shown in Table 3-3 following. A 0 
response disconnects the terminal's transmitter from the multiplexer. 


Table 3-3 
Multiplexer Terminal Speeds 


0 50 75-110 134.5 150 200 


300 600 1200 1800 2400 4800 9600 


(Except for 0, all entries are baud rates.) 
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3.9.9 Modify Magtape Default Mode Questions 


This section (see Figure 3-10) allows the user to establish and modify 
the tape format to be used for all magtape I/o ! These questions 
are asked only if TMll's or TJU16's have been specified (see Section 
3.9.2). The format specified may be either DOS-11 compatible (ASCII 
characters, DOS labelling, and Stream Data format) or any combination 
of the following: 


Character Set - ASCII or EBCDIC 
Labelling - Standard labelling or unlabelled 
Format - Stream data or variable length records. 


For the TJU16, the user must also specify the tape density desired 
(800 BPI or 1600 Phase Encoded BPI). The density for the TMll is. 
automatically set to 800 BPI. 


NOTE 


If the EBCDIC character set is selected, 
the user must’ be sure that the EBCDIC 
module was linked during the SYSTEM 
BUILD procedure described in Chapter 2. 


MODIFY MAGTAPE DEFAULT MODE 


LONG FORMAT (EXPLANATION) OR SHORT (TYPE Lo OR So? L 
MODIFICATION QFTIONS ¢ 
CHARACTER SET ~ CAISCIT OR CEO BCOIC 
FORMAT ~ (STREAM DATA OR (CYOARTABLE LENGTH RECORES 
LABELLING ~ (LOABELLED (STANDARD OR (CU) NLABELLEN 
HENSITY ~ 800 BET OR 1600 FHASE ENCORED RFI 
DOS~11 COMPATIBLE ~ ASCII CHARACTERS» [0S LABELLING, 

AND STREAM DATA FORMAT 


CURRENT MAGTAPE DEFAULT MOWE IS? 


NOS COMPATIBLE» 800 BFI 


LABELLING CTYPE L OR Uo? U 
FORMAT (TYFE S OR Vat ¥ 


Figure 3-10 SYSGEN Session: Modify Magtape Default Mode 


After identifying itself, this session begins operation by requesting 
that the user specify whether a description of the various 
modification options is desired or not. 


1. The Magtape Format Mode may be temporarily modified by any user via 
the ASSIGN command, as explained in the MUMPS-1l1 Language Reference 
Manual (DEC-11-MMLMA-D-D) . 
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LONG FORMAT (EXPLANATION) OR SHORT (TYPE L OR S): 


L 

ale 

Thereafter, the program outputs the current Magtape Default Mode if 
MSP (Modify System Parameters Program) is running under the control of 
SYSGEN; the default mode will be DOS-11 compatible and proceeds with 
its interactive dialogue, as follows: 


ee 


MODIFY CURRENT MAGTAPE DEFAULT MODE? (Y OR N): 


Y 
de 


If the current default parameters are satisfactory, type N; 
otherwise, type Y. 


NOTE 


All remaining questions are skipped if N 
is typed to the MODIFY CURRENT MAGTAPE 
DEFAULT MODE question. 


DOS-11 COMPATIBLE FORMAT ? (Y OR N): E J 


N 


Type Y if the ASCII character set, DOS labelling, stream data format 
are desired; otherwise, type N. A Y causes the next three questions 
to be skipped. 


ASCII or EBCDIC (TYPE A OR E): |A 


2 | 


Type A if the ASCII character set will be used; type E if EBCDIC 
translation is desired. An E will cause ASCII characters to be 
translated to EBCDIC on output and EBCDIC characters to be translated 
to ASCII on input. E should not be selected unless the EBCDIC module 
was linked during the SYSTEM BUILD. If the EBCDIC module was’ linked, 
the user may still select the ASCII character set. 


LABELLING (TYPE L OR U): E bay 


U 


If L is typed in response to this question, ANSI standard labelling 
will be used if the ASCII character set has been specified (see 
previous question). IBM standard EBCDIC labels will be used if the 
EBCDIC character set has been specified. Type U if no labels are 
desired. 


ee 


FORMAT (TYPE S OR V): E 
Vv 


Type S if stream data format is desired. On output, characters are 
sequentially packed into the buffer; a CR-LF is translated to a LF, 
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and an argument of a TYPE command is not split across a block 
boundary. On input, LF's, FF's, and HT's (write end of file labels) 
are treated as string delimiters, and CR's are ignored. TYPE V_ to 
select Variable Length logical records (ANSI standard "D" format). If 
V is entered, each argument of a TYPE command corresponds to a logical 
record which can be read as a single argument of a READ command. 


DENSITY: aaaa_/ 
This question is asked only if TJU16's are incorporated into the 


system. The number (aaaa) entered must be either 800 or 1600 (Phase 
Encoded) BPI. 


NOTE 


The Magtape Default Mode selected 
applies to all magtape drives. 


3.9.10 Miscellaneous System Information Questions 


This section (see Figure 3-11) contains questions covering a variety 
of subject areas, as follows: 


IS THE POWER LINE FREQUENCY 60 H2 (CY OR ND? Y 


nad YOU HAVE ANY VECTORS ABOVE LOCATION 400 OCTAL (CY OR ND? N 
OO YOU WISH TO RESTRICT OVERFLOW BETWEEN [DISK UNITS (CY OR NO? N 


NO YOU WISH WRITE CHECK AFTER WRITE ON DISKS CY OR NDP ON 


TYPE IN DATE MM/DD/YY L/29777 NEW DATE 29 JAN 77 


TYPE IN TIME HH?MM 17208 NEW TIME ueOg. 


Figure 3-11 SYSGEN Session: Miscellaneous Questions 


IS THE POWER LINE FREQUENCY 60 HZ (N OR <CR>)? 


4 

ae. 

The power line frequency directly affects the timing interval (or time 
between ticks) of the MUMPS internal clock. At 60 HZ, one tick = 16.6 
milliseconds. At 50 HZ, one tick = 20 milliseconds. Since’ the 
system's time sharing interval (standard time slice value) is based on 
ticks, the power frequency directly affects the amount of CPU time 
allotted to each active job (i.e., terminal user or program) in the 
system. In response to this question, the user can type: 


N (Carriage RETURN) to specify a 50 HZ power line frequency. 
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DO YOU HAVE ANY VECTORS ABOVE LOCATION 
400 OCTAL (Y OR N)? |x| 
N ~ 


A proper response to the next two questions allows the user to set the 
software's system stack limit register. All device interrupt vectors 
use low memory addresses. Each vector normally occupies four 
consecutive locations. Large configurations, however, may have 
vectors which use memory space above location 400 (octal). If the 
last used vector base address is 370 (octal) or less, type N. (SYSGEN 
skips the next question). If the hardware is wired with vectors above 
400 (octal) type Y. 


TYPE IN OCTAL ADDRESS OR FIRST LOCATION 
ABOVE LAST VECTOR: aaa./ 


This question is output if the response to the last question was Y. 
The system needs to know the address to be used as the low limit of 
the system stack. Enter the octal address (aaa) of the first free 
memory word above the last interrupt vector used by the hardware. Low 
Memory vector words are grouped four words per device. 


Example: If a second line printer has been installed with interrupt 
vector words at 520 (octal), the user would type in 530. 


DO YOU WISH TO RESTRICT OVERFLOW BETWEEN 
DISK UNITS (Y OR N)?: |/Y 
N ~/ 


Unless otherwise specified, MUMPS allows program and global storage 
areas to cross physical disk unit and disk system boundaries. This 
Means that all physical disks are normally treated as one logical 
disk. This option allows the user to override normal operation. This 
option is most often selected when the user wishes to relegate globals 
and programs belonging to specific UCIs to particular disk units. To 
accomplish this, the user must have previously allocated his global 
and program directories to the desired disks (see Section 3.9.6, 
question on Directory). If this restriction is desired, type Y (MSP 
skips the next question); otherwise type N. 


DO YOU WISH TO RESTRICT OVERFLOW BETWEEN 
DISK SYSTEMS (Y OR N)?: | Y 
N ~ 


This question is similar to the last except that the restriction is 
now between disk systems (i.e., RK, RF, RS, RM, RP and RJ) rather than 
disk units. Answer Y or N as desired. 


DO YOU WISH WRITE CHECK AFTER WRITE ON 
DISK UNITS (Y OR N)?: |Y 
N </ 


A proper response to this question allows the user to validate data 
being output to the disk. MUMPS normally verifies disk-stored data 
during input only. This means that any errors that are generated 
during output are not detected until an attempt to input is made. At 
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this point it is usually too late to correct the error. This question 
allows the user to specify that MUMPS validate all data output to the 
disk at the time of the output operation. This allows the program 
performing the output to effect a graceful recovery without subsequent 
data loss. When this option is selected, the time required for each 
physical write operation is increased by at least one disk revolution 
time. If this feature is desired, type Y; otherwise type N. 


TYPE IN DATE MM/DD/YY mm/dd/yy / 


MSP calls the DATE SET (DAT) System Program so that the user will have 
a record of the system's creation date. Enter the current date 
(mm/dd/yy). A system's creation date can be examined using the $&%D 
Library Utility Program immediately after reinitializing the system 
from the disk, or from other backup media. 


TYPE IN TIME HH:MM hh:mm_/ 


MSP calls the TIME SET (TIM) System Program so that the user will have 
a record of the system's time of creation. Enter the current time (24 
hour notation, hh:mm). A system's time of creation can be examined by 
using the $%T Library Program immediately after the system is loaded 
into memory from the disk or from other backup media. 


NOTE 


If a system merge, RKO5 or RKO6 
distribution is being executed, the Disk 
Block Tally program (DBT) will be called 
at this point. 


3.9.11 Saving The New System 


After all questions have been satisfactorily answered, the new system 
residing in memory must be written out onto the save area of the 
system disk. To accomplish this, MSP types out the set of 
instructions (see Figure 3-12) which the user must follow. Once the 
system has been saved, a backup copy of the system disk should be made 
using the Backup and Utility Program described in Appendix I. 


RAISE SWITCH REGISTER SW #12 


AFTER MUMFPS TYPES “EXIT’ SAVE THE CORE IMAGE ONTO THE SYSTEM INTSK: 
1) HALT THE MACHINE» LOWER ALL SWITCHES ANT LOAD ANURESS 30 (8)» 
2) RAISE HALT SWITCH ANT DEPRESS STARTs 

3) RAISE SWISS AND DEPRESS CONTINUE. 

THE SYSTEM IS TRANSFERRED TO THE TISK. 


KANO TEX “SYS HAS BREEN FARTIALLY BUILT BY SYSGEN. 
“SYS IS & RESERVED GLOBAL AND SHOULT NOT BE DESTROYED. 


EXIT 


Figure 3-12 SYSGEN Session: Saving the New System 
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3.9.12 Changing System Parameters 


The user can alter system parameters covered by MSP sections of this 
chapter (see Sections 3.9.6 through 3.9.11 but excluding question in 
Section 3.9.7 on CPU-CPU device) simply by running MSP by itself (see 
Chapter 6). Changes to parameters 3.9.1 through 3.9.5 can only be 
made by initiating a new SYSGEN session (see Section 3.6). 


CHAPTER 4 


OPERATOR FUNCTIONS 


4.1 INTRODUCTION 


This chapter contains reference information on the use of the SWITCH 
REGISTER switches(1), used by all PDP-11 machines except for the 
PDP-11/34. Figure 4-1 shows a typical control console for a PDP-ll 
which uses these switches!. Figure 4-2 shows the function 
assignments for the individual switches. Reference information is 
also provided on the use of the control buttons for the Programmer's 
Console of the PDP-11/34 (see Figure 4-3)7, Also contained in this 
chapter is information on the console terminal, as well as procedures 
for loading and starting, restoring, restarting, saving and shutting 
down the system. 


While MUMPS is running, various control operations can take place at 
the user terminals, the console terminal, the PDP-11 SWITCH REGISTER 
or at the Programmer's Console (PDP-11/34). Users can log in to the 
system from various terminals, run existing programs, and create and 
modify programs and globals residing within their respective UCI's. 
In addition, various Library Utility Programs can be run and Library 
Globals accessed. 


The console terminal may be used as a regular MUMPS terminal or as an 
operating terminal for the system's Mini-ODT (Octal Debugging 
Technique) program. The SWITCH REGISTER switches and the Programmer's 
Console buttons control the operation of various functions in the 
operating system to facilitate daily operations and periodic 
Maintenance. 


4.2 PDP-11 SWITCH REGISTER AND CONSOLE BUTTON USAGE 
—— ee ee ee oe eee eee 


The SWITCH REGISTER switches on the PDP-1l determine both the function 
of the console terminal and the operational status of the system in 
general. The position of all SWITCH REGISTER switches for normal 
MUMPS operation is OFF (down). 


Table 4-1 shows the equivalent values of the SWITCH REGISTER switches 
for the PDP-11/34. To have the equivalent of two or more switches 
being raised simultaneously, on the PDP-11/34, simply add the octal 
values of those switches together and key in the result on the 
console. For example, to disable both garbage collection and log-ins, 
key in the octal value 120. 


1. For further information, refer to the specific processor handbook 
needed. These are listed in the Introduction, page 1-2. 


2. For further information, refer to the PDP-11/34 Processor Handbook. 
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NOTE 


To key in the equivalent of two or more 
switches on the PDP-11/34, be sure to 
add the octal values together. If this 
adding procedure is not followed, the 
first value keyed in will then be 
overwritten by the next value keyed in. 


The paragraphs which follow describe the function and usage of PDP-1ll 
SWITCH REGISTER switches in greater detail. A switch is set to 1 when 
it is in the raised position and to 0 when in the lowered position. 


Figure 4-1 PDP-1l Switch Register Console 


4.2.1 Switch 0 


This switch controls the use of the console terminal. When switch 0 
is set to 0, the console terminal operates as a normal MUMPS terminal. 
Any user can operate from the terminal under any of the legitimate UCI 
codes. When switch 0 is set to 1, the console terminal operates 
independently of the MUMPS interpreter under control of the Mini-ODT 
program which is embedded in the operating system. Mini-ODT can run 
concurrently with other regular MUMPS system operations. The system 
need not be shut down. The program permits the direct examination and 
modification of memory locations using octal numbers. Operational 
features of Mini-ODT are discussed in Section 4.3.1. 
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4.2.2 Switch 4 


This switch controls the operation of the system's Garbage Collector 
routine. This routine is used to deallocate disk blocks that have 
been discarded as the result of the modification of global files and 
programs. In addition, the routine continually updates copies of 
certain memory resident tables which are part of the core image of the 
system contained on the system disk. When the switch is set to 0, the 
Garbage Collector operates; setting the switch to 1 disables’ the 
Garbage Collector. This switch should always be set to 0, except as 
directed by the SSD System Utility Program. 


4.2.3 Switch 6 


This switch is used to effect a normal system close. Once the switch 
has been set to 1, all users, including the console terminal user, 
attempting to log in to the system will receive the message: 


"SYSTEM IS DOWN' 


Furthermore, as current users (including the console terminal user) 
complete their terminal sessions, they too will be unable to log in. 
This switch does not interact with switch 0 and has no effect upon the 
operation of Mini-ODT. User system application programs should check 
this switch periodically in order to initiate their. own shutdown 
procedures when switch 6 is set to l. 


4.2.4 Switch 12 


This switch controls the granting of partitions. When switch 12 is 
set to 0, each time a user presses his BREAK key, types CTRL/C or 
STARTS a program, MUMPS grants a partition -- even when Switch 6 is 
set to 1. When Switch 12 is set to 1, the system is effectively 
closed. MUMPS outputs an @ symbol when a user attempts to log in. 
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PDP -11SWITCH REGISTER 


INTEPRETER CONTROL SYSTEM SHUTDOWN 
O=ENABLE O=DISABLE 


1=DISABLE PARTITION GRANT 1=ENABLE 


O=ENABLE 
1=DISABLE GARBAGE COLLECTOR 


CONTROL 
SYSTEM PROCESSING O's ENAGLE. 
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Figure 4-2 Switch Register Function Assignments 


4.2.5 Switch 13 


This switch controls the entire operation of the system. When set to 
1, all MUMPS-11 operation ceases except for the processing of hardware 
interrupts. Mini-ODT operation is not affected. 


4.2.6 Switch 15 


This switch, when set to 1, disables operation of the interpreter for 
all jobs, except the job currently executing a disk I/O task. This 
job is also disabled upon task completion. The operation of Mini-ODT 
or the 'Garbage Collector' is not affected, however. 


OPERATOR FUNCTIONS 


Figure 4-3 PDP-11/34 Programmer's Console 


4.3 USING THE CONSOLE TERMINAL 
The console terminal has four main functions in the MUMPS system: 
e It is used to operate Mini°ODT (octal debugging routine). 


e It is used for ‘Garbage Collector' error reporting (see 
Section 5.1.3). 


e It is used for running the privileged system utilities 
MSP,BCS and SSD (see Chapter 6). 


e It is used as a regular MUMPS terminal. 


4.3.1 Running Mini-ODT 


Mini-ODT is an octal debugging program embedded in the MUMPS-11 
operating system. It permits examination and modification of PDP-11l 
memory locations. The routine is interrupt driven and operates at the 
same time MUMPS is running. Mini-ODT can only be used at the console 
terminal. Log-in is not required. Figure 4-4 is a typical Mini-ODT 
session (user responses are underlined and are terminated by ALTMODE). 


Mini-ODT allows the operator to: 
1. Open the location specified by an octal address. 
2. Print the contents of that location (in octal). 
3. Modify the contents of that location (in octal). 


4. Close that location and open the next sequentially higher 
location. 
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Memory locations can be accessed either as 16-bit words (Word Mode) or 
as 8-bit bytes (Byte Mode), as the user requires. 


4.3.1.1 Operation - Mini-ODT is entered by setting SWITCH REGISTER 
switch 0 to l. 


NOTE 


If SWITCH REGISTER switch 0 is set to 1 
while a MUMPS job is performing an 
output operation to the console 
terminal, the job's output is suspended. 
To recover control of the terminal, set 
Switch 0 to OFF, then type <CR> or 
CTRL/C. 


Once the switch is set to 1, operation can begin. Log-in is 
unnecessary. The user can type up to 6 numeric characters to specify 
the desired address. Words are accessed by specifying even addresses 
(e.g., 03722) while byte addresses can be either odd or even. 


The mode of operation, either byte or word, is set by prefixing, 
suffixing, or inserting either a W (for word mode) or a B (for byte 
mode) into the desired address. All subsequent requests are assumed 
to be in the mode last specified. Thus, typing in an odd address 
while in word mode produces the '?' error message. 


The paragraphs below describe the procedures to be followed when using 


Mini-ODT. Input from the user is represented by AAA (address) or MMM 
(modified contents), and output from Mini-ODT by NNN. 


4.3.1.2 Opening a Location - To open a location for examination or 
modification, type the desired octal address terminated by an ALTMODE. 
Mini-ODT responds by typing a slash (/) followed by the octal contents 
of that location. Thus: 
Word Mode: 
AAAAAA (ALTMODE) /NNNNNN 
Byte Mode: 
AAAAAA (ALTMODE) /NNN 


Mini-ODT then waits to permit the user to either modify or close the 
location. 


4.3.1.3 Changing the Contents of a Location - To change the contents 
of an opened location, enter up to 6 octal digits (3 if in byte mode) 
followed by ALTMODE. 

AAAAAA (ALTMODE) /NNNNNN MMMMMM (ALTMODE) 


Mini-ODT responds by entering the change into memory and closing that 
location. 
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4.3.1.4 Closing a Location Without Change - To close a location but 


not change it, type ALTMODE immediately after the type-out of its 
contents: 


B4352(ALTMODE) / 053 (ALTMODE) 


4.3.1.5 Advancing to the Next Location - To examine the next higher 
location in sequence, type ALTMODE. 


Mini-ODT types: 


AAAAAA/NNNNNN 
if in Word Mode 


AAAAAA/NNN 
if in Byte Mode 


To advance to any other location (not in sequence), enter the desired 
addressing mode, if it is to be changed, and a new address as shown in 
the previous Section 4.3.1.2. 


4.3.1.6 Correcting Errors - In a non-numeric character, if a decimal 
number, or a byte address (odd address when operating in a word mode) 
is entered, Mini-ODT ignores the entry and types a question mark (?). 


2? 
W207 (ALTMODE) ? 


If a non-numeric character or decimal number is entered as the new 
contents of a location, Mini-ODT ignores the entry, types a '?' and 
waits either for the new contents to be entered or for the location to 
be closed. 


B2234 (ALTMODE) /003 3? 
Also, the same condition results if, when in byte mode, a number 


larger than three digits is input. If an error is detected, the 
entire string is ignored. 


1020/ 000000 Examine word at 1020 
Change the contents of word at 150006 
Examine five successive bytes, 
changing the third and fourth 


Examine word at 45342 
Examine next successive word 
7144/ 116700 113700 Examine three successive words, 
007146/ 172310 changing the first and third 
007150/ 116000 777 
Attempt to examine a byte in Word Mode 
(odd address) 
Correction for above 
Wrong address, typed an "X" to 
discard the line. 
Open correct address and change contents 
to 17. 


Figure 4-4 Typical Mini-ODT Session 
ah 
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4.3.2 Using the Console Terminal as a MUMPS Terminal 


When SWITCH REGISTER switch 0 is set to 0, the console terminal 
operates as a regular MUMPS terminal. Users can log in under any 
legal UCI and create, run, modify, and file programs, as described in 


the MUMPS-11 Programmer's Guide. 


4.4 CREATING SYSTEM BACKUP 


The system manager of each MUMPS installation should create and retain 
a duplicate copy of the contents of each disk in his system. This can 
save considerable time if a system crash (failure) occurs, whether it 
is caused by hardware or software. The number of copies to be made 
and the frequency with which they are created depend in large part 
upon the amount of system activity on the disk. It is not uncommon 
for an installation to create a backup copy of the system at the close 
of each day's activity. There are two basic types of backup; 
physical backup and logical backup. 


4.4.1 Logical Backup 


Logical backup allows an individual user to save specified programs 
and globals listed in the directory of a particular UCI while the 
system is running. 


This is normally accomplished by each UCI user via the %GS and $%PS 
Library Utility Programs described in the MUMPS-1l Programmer's Guide. 
These programs are particularly useful when creating a user's private 
backup or. when it is necessary to install programs or globals into 
another MUMPS-11 system. These programs do not, however, save the 
system image or the physical disk data structure. 


4.4.2 Physical Backup 


The MUMPS Backup and Utility System (MBU) allows the MUMPS'- system 
Manager to backup or save the contents of any MUMPS-created disk, 
tape, global file directory, or individual global file. The backup 
medium may be magnetic tape, DECtape or any disk type supported by 
MUMPS. This program allows the operator to later restore the MUMPS 
master volumes from the backups, in the event that programming errors 
or a system crash lead to the loss of important information. 
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MBU provides the following MUMPS-related functions: 


1. Backup the contents of any MUMPS-structured disk volume onto 
disk, magtape or DECtape. 


2. Restore a MUMPS disk volume from a backup thus created. 


3. Save the contents of an entire MUMPS global directory, or of 
individual global files, on disk, magtape or DECtape ina 
Manner which will enable efficient restoring later, should 
data become lost due to hardware or software problems. 


4. "Initialize" or "Format" a disk. This operation 
automatically checks for unusable areas on the disk (bad 
blocks) and prevents the MUMPS system from trying to use 
these areas. 


5. "Label" a disk. This operation allows the user to give each 
disk volume a unique "name", and furthermore, to declare 
whether or not the given volume is to be used as a "master" 
or as a “backup" volume. A master is a volume containing the 
data in its original form, as used by MUMPS. A backup is any 
volume created by use of the MUMPS Backup Program BACKUP 
command. Additional special functions, such as_ special 
handling of bad or suspected bad blocks, setting magtape 
densities, or specifying non-standard interrupt vector or 
status register addresses, are described in Appendix I. 

4.4.3 Saving the System Image 

The MUMPS-11 operating system contains a special save routine that is 
used to save the system memory image on the system disk. When 
started, the routine transfers a copy of the system memory to the save 
area of the system disk. This copy is used to load memory prior to 
startup (see Section 4.5.2). The save routine can be used only when 
MUMPS is not running. 


For all PDP-1l's except the 11/34, use the Console Control Switches to 
perform the following steps: 


1. Make sure there is no activity on system (run SSD) 
2. Press HALT 

3. Set SWITCH REGISTER Switches to 50(8) 

4. Press LOAD ADRS 

5. Raise HALT 

6. Press START 

7. Raise SWITCH REGISTER Switch 15 

8. Press CONTINUE. 


For the PDP-11/34, use the Console Control Buttons to perform the 
following steps: 


1. Make sure there is no activity on the system (run SSD) 


2. Press and hold CNTRL, while pressing HLT/SS 
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3. Set Display Register to 40(8) by pressing the set of numbered 
buttons on the console 

4. Press LAD 

5. Press and hold CNTRL, while pressing HLT/SS 


6. Press and hold CNTRL, while pressing START 
7. Key in the octal value 100000 (see Table 4-1) 
8. Press and hold CNTRL, while pressing CONT. 


Then set all SWITCH REGISTER Switches to 0. 
out the Display Register.) 


(For the PDP-11/34, zero 


Table 4-1 
PDP-11/34 Values for SWITCH REGISTER 
Function Assignments 


Mini-ODT 
Garbage Collector 


Disable Log-in 


1 
20 
100 


Disable Partition 
Grants 10000 
Disable Entire 


System 20000 


Disable Interpretor 


100000 


When the operation is complete, the system is automatically restarted. 
Thereafter, users can log in and continue normal operation. 


4.5 LOADING, STARTING AND RESTARTING THE SYSTEM 


The paragraphs that follow describe various 
starting, and restarting the MUMPS-11 system software after system 
generation, Procedures for loading and starting the Basic 
(un-SYSGENed) System are provided in Sections 2.6.1 and 2.7.2. The 
MUMPS system software is loaded, started or restarted in several ways, 
depending upon the following circumstances: 


procedures for loading, 


e If MUMPS is currently in memory, it can be started using the 
system's internal restart routine. 


e If MUMPS is not in memory but is on the system disk, it can 
be loaded and started via the PDP-ll's Read Only Memory (ROM) 
Bootstrap Loader. 


e If MUMPS is neither in memory nor on the system disk, it can 
be restarted by loading it onto the system disk from backup 
media via the Backup and Utility System (MBU). Thereafter, 
it can be loaded into memory via the toggle switches (or 
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buttons, if using the PDP-11/34) by the ROM Bootstrap Loader. 
The following sections describe these procedures in detail. 


4.5.1 System Restart 


The MUMPS-11 operating system contains a special routine to restart 
the copy of the MUMPS operating system residing in memory. Restart is 
often used to start up the system after it has been shut down or _ to 
restart the system after a system failure. When a restart after a 
failure is successful, only those users currently being serviced by 
the system run the risk of loosing their data and ASSIGNED devices. 
(Chapter 5 describes system error detection and recovery procedures.) 


For all PDP-ll's except the PDP-11/34, restart is performed using the 
Console Control Switches, as follows: 


1. Press HALT 

2. Set SWITCH REGISTER Switches to 40(8) 
3. Press LOAD ADRS 

4. Raise HALT 

5. Press START. 


For the PDP-11/34, restart is performed using the Console Control 
Buttons (refer to Figure 4-3) as follows: 


1. Press and hold CNTRL, while pressing HLT/SS 


2. Set Display Register to 40(8) by pressing the set of numbered 
buttons on the console 


3. Press LAD 
4. Press and hold CNTRL, while pressing HLT/SS 
5. Press and hold CNTRL, while pressing START. 


Then set all SWITCH REGISTER Switches to 0. (For the PDP-11/34, zero 
out the Display Register.) 


After restart, users can log into the system in the normal way 
(described in the MUMPS-1]1 Programmer's Guide). If restart occurs 
after a system error, some devices may have become inaccessible to 
users, Appropriate procedures are provided in Chapter 5 to remedy 
this situation. 


4.5.2 Loading The System Into Memory From Disk 


The MUMPS Operating System, after system generation, resides as a 
Memory image at a known location (system save area) of the system 
disk. This is the normal medium on which the working copy of the 
MUMPS system resides. When MUMPS has been shut down due to problems 
which might have caused alteration of the system's memory image, the 
system is loaded and started from disk, as follows: 


OPERATOR FUNCTIONS 
1. Make sure all disks used by MUMPS are loaded, switched on, 
and on line. The system disk must be on drive 0. 


2. Set the drive control ON LINE/OFF LINE to ON LINE, and _ the 
drive control WRITE ENABLE/WRITE LOCK to WRITE ENABLE. 


3. Set the SWITCH REGISTER switches to the ROM Bootstrap address 
for the disk being used (see Chapter 2, Section 2.5) 


4. Operate the Console Controls for the specific processor being 
used, as follows. 


A. For all PDP-1l's except the PDP-11/34, operate the Console 
Control Switches in the following sequence: 


a. Press HALT 
b. Press LOAD ADR 
c. Raise HALT 
d. Press START 


B. For the PDP-11/34, operate the Console Control Buttons in 
the following sequence: 


a. Press and hold CNTRL, while pressing HLT/SS 
b. Press LAD 

c. Press and hold CNTRL, while pressing HLT/SS 
d. Press and hold CNTRL, while pressing START. 


Then set all SWITCH REGISTER switches to 0. (For the 
PDP-11/34, zero out the Display Register.) 


If loading is successful, MUMPS prints 
MUMPS-11 Vnn RELOAD 
(nn = version number) 


at the console terminal, then runs the system Startup 
Program (refer to Chapter 6). 


If loading is not successful, repeat steps 1 through 5 above. If 
loading is still unsuccessful, a backup copy of the system, created by 
the Backup and Utility System (MBU), must be used (see Section 4.4). 
If no system backup exists, the user must rebuild the system (as 
described in Chapter 2) then re-SYSGEN the system (Chapter 3) and 
restore all logically saved programs and globals using the %PL and %GR 
programs. we 


4.5.3 Restoring the System Disk from Backup Media 


The restart and disk bootstrap procedures previously described require 
that the operating system be resident either in memory (for restart) 
or on the system disk (for bootstrap). If, through some hardware or 
software malfunction, the system disk is damaged (e.g., by a head 
crash), these procedures cannot be used. Either a new system must be 
created (see Chapters 2 and 3) or a backup copy of the system must be 
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obtained to restore the system to its normal operating configuration 
and condition. MBU, described in Section 4.2, is used not only to 
create physical data backup of any disk but also to restore the data. 
By creating and maintaining recent backup copies of disks, via MBU, 
the system manager can restore a system in a relatively short time. 
Otherwise, time-consuming system build (SYSBLD) and generation 
(SYSGEN) sessions are necessary simply to recreate the operating 
environment, and user-created programs and global data must also be 
restored or recreated. Detailed operating procedures for MBU are 
provided in Appendix I. 


4.6 SYSTEM SHUTDOWN 


Periodically, the system manager must terminate MUMPS system operation 
to perform various hardware and software maintenance tasks or to 
remedy some error condition. A shutdown may not necessitate an actual 
system halt (pressing the HALT switch). The system may only need to 
be shut down to time-sharing users. Such is the case when certain 
System Utility Programs (e.g., MSP,DBT, etc.) are to be run by the 
system manager. On the other hand, the system must be halted 
completely when MBU is to be run. Because of the complexity of system 
operations in the MUMPS timesharing environment, system shutdown must 
be performed in an organized, step-by-step manner. 


Before halting the system, all users, including the console terminal 
user, must log out. Furthermore, the Garbage Collector routine must 
also have completed its operation. The system must never be halted 
during time-sharing operation, for this can cause terminal users much 
difficulty and wreak havoc upon the disk file structure. 
Specifically, the following can occur: 


e Users can lose all partition-resident data and programs. 


e Disk system management and space allocation data can be lost, 
resulting in unknown states for programs and global data. 


The normal way to bring the system to the point where the processor 
can be HALTed, is by using the SSD (System Shutdown) System Utility 
Program. SSD tells the system manager the exact procedures to be 
followed in closing down a MUMPS-11 System, including the various 
console SWITCH REGISTER switches to be used (refer to Table 4-1 for 
the Equivalent Console Button Values), and how to deal with 
uncooperative users. In addition, it also runs the SS and DBT 
programs upon request. Further information on SSD is provided in 
Chapter 6. 
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ERROR DETECTION AND RECOVERY 


This chapter contains information to assist the system manager in 
recognizing and dealing with MUMPS-11 software and hardware error 
conditions. 


There are three major classes of errors that can occur in a MUMPS-11 
system: 


1. Programming and Operating System Errors 
2. Mass Storage Hardware Errors 
3. System Crash Errors 


The following paragraphs describe in detail the errors in each class. 


5.1 PROGRAMMING AND OPERATING SYSTEM ERRORS 


Most of the errors in this class are job-related and are reported by 
MUMPS either as typed messages to the appropriate terminals or as 
interrupts, via the $E System Variable, to specific user programs. 
These errors are described in Appendix C. 


Errors described in paragraphs C.1, C.2 and C.3 of Appendix C are 
general programming errors. These errors usually occur during program 
development and result from faulty programming technique (e.g., 
insufficient partition space for a program or its variables, incorrect 
syntax, etc.). Recovery from errors of this type is straightforward 
(except for NAKED and DKSER errors) and further explanation is 
unnecessary. 


The operating system errors described in paragraph C.4 are more 
serious and deal with the viability of the operating system itself. 
Recovery from errors of this type can be difficult and time consuming. 
A thorough understanding of the operating system and the application 
programs can be very helpful. In some cases, assistance from a 
DIGITAL Software Specialist may be necessary. Operating system errors 
are divided into two groups: those that are caused by the operating 
system in response to the operation of a specific job, and Garbage 
Collector errors, which are system-caused and job-independent. 


5.1.1 Programming Errors 


The paragraphs which follow provide information on Programming Errors 
for which recovery is most difficult, and supplement the information 
in Appendix C. 
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5.1.1.1 NAKED 


This error indicates an illegal naked access and is often caused by a 
user-created, time-sharing conflict in the application software. For 
example, assume program A KILL's parts of a global that program B is 
currently referencing via naked syntax. When this happens, the 
system's Garbage Collector clears user B's disk pointers, thereby 
preventing further naked references and causing the NAKED message to 
be output to him. 


5.1.1.2 DKSER 


This error normally indicates there was an illegal use of the VIEW 
command by attempting to: 


1. Access a disk block number less than l. 


2. Access a disk block number higher than is available on the 
disk. 


3. Reference a block on a nonexistent disk drive. 


DKSER can also occur, however, during a global reference. This is 
usually caused by the detection of an invalid disk block number in a 
pointer. This means that either the user (via VIEW) or the operating 
system itself has altered the pointer incorrectly. The system manager 
should call his DIGITAL Software Specialist for assistance if the 
error appears to be the fault of the operating system. 


5.1.2 Operating System Errors (non-Garbage Collector) 


The paragraphs which follow provide information on Operating System 
Errors for which recovery is most difficult, and supplement the 
information in Appendix C. 


5.1.2.1 DKDER 


This error is a variation of the DKHER error described below. Though 
the cause of this error. is the same as for the DKHER error (disk 
hardware failure), the circumstances of its occurrence are different. 
DKDER is generated during an output operation to the disk that was 
initiated by the operating system (as opposed to the user). DKDER 
occurs when the system determines that the current disk block must be 
written out (e.g., user's program was swapped out, a continuation 
block was needed, a different global level was accessed). 


5.1.2.2 DKHER 


This error occurs when a disk hardware error is detected while a job 
is attempting to read or write disk data. Though the request is 
accepted, it cannot be completed. Hardware errors can be caused by 
the following: head crash, disk off line, a write-protect violation, 
inability to read previously written block, or power failure. 
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5.1.2.3 PLDER 


This message indicates that the program being CALLed, STARTed, 
OVERLAYed, or LOADed was FILEd incorrectly by the system. The user 
must refile a backup copy of the program. Recurrence of the error 
indicates a disk data structure problem. 


5.1.2.4 SWAP 

Whenever a job's time slice expires, the job becomes inactive, and the 
system starts up another job. During the job's inactivity, the 
contents of the system stack are saved in the inactive job's partition 
overhead area (see MUMPS-11 Programmer's Guide, Appendix G). This 
error occurs when the system stack cannot fit on the user. stack 
because of insufficient partition space. 


5.1.2.5 SYSDG 


This error is caused by the detection of a discrepancy between the 
memory resident Disk Storage Allocation Table (DSKSAT) and the disk 
resident bit maps. This usually results from indiscriminate or 
disorganized system shutdown procedures. The DBT program (Chapter 6) 
should be run to correct the problem. 


5.1.3 Garbage Collector Errors 


The Garbage Collector is a routine which resides within the operating 
system. It is used to recover deallocated disk storage blocks for the 
system. As a part of its operation, the Garbage Collector performs 
error checking to determine the validity of its operations. 
Appropriate error messages are output in the form GARBn, where 'n' is 
the message number. All error messages are output to the console 
terminal. Because these errors can have a serious impact on _ the 
system, output of these error messages takes precedence over any other 
output operation at the console terminal. Further, the occurrence of 
any of these errors indicates that the integrity of the data base is 
questionable. The system manager should initiate appropriate data 
base recovery procedures. 


There are two types of errors, as shown below, Read Errors and Write 
Errors: 


Read Errors: 
GARBO Error on reading data block! 
GARB2 Error on reading bit map 


GARB4 Block being collected is itself a bit map. 
DANGEROUS ERROR 


Write Errors: 
GARB1 Error while writing a data block 
GARB3 Error while writing a bit map 
l. This error will occur when starting the system via the ROM 


bootstrap loader if the system disk is set to WRITE LOCK. 
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When Read Errors occur, normal system operation continues after the 
error message is output. The console terminal user, however, will 
have to re-initialize this terminal by typing CTRL/C (if a MUMPS 
terminal operation was in progress) or ALTMODE (if a Mini-ODT 
operation was in progress). If the error is a Write Error, the disk 
is locked out and is unavailable for further use. To regain use of 
the disk, clear the Disk I/O Bound Queue using Mini-ODT as_ shown 
below: 


1. Set SWITCH REGISTER switch 0 to l 
2. Examine the contents of location 54(8): 
54 (ALTMODE) /NNNNNN (ALTMODE) 


3. Using the contents of 54 as an address, examine the contents 
of NNNNNN: 


NNNNNN (ALTMODE) /MMMMMM (ALTMODE) 


4. Add 32(8) to MMMMMM yielding XXXXXx. Open byte location 
XXXXXX and change its contents to 0. 


BXXXXXX (ALTMODE)/377 0 (ALTMODE) 


NOTE 


If the Garbage Collector is reporting 
errors continuously at a rapid rate, it 
Must be disabled before proceeding with 
recovery procedures. To do this, set 
SWITCH REGISTER switch 4 to 1 (raised 
position). 


5.1.4 Errors Requiring DEC Assistance 


The Programming and Operating System Errors shown below often require 
the assistance of a DIGITAL Software specialist: 


DBDGD 
DKSER 
DSKDG 
GARB4 
SYSER 


When these errors occur, the user should run both the Disk Block Tally 
(DBT) and Caretaker Reporter (KTR) programs. The reports produced by 
DBT and KTR should be saved for use by DEC personnel in diagnosing the 
problem.- After the programs have completed operation, the system 
should be shut down by using the System Shutdown Program (SSD). Refer 
to Chapter 6 for descriptions of the System Utility Programs. 
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5.2 MASS STORAGE HARDWARE ERRORS 


In addition to reporting the hardware errors discussed in Section 5.1, 
and Appendix C, Section C.4, MUMPS also maintains an internal log of 
some of these errors. This includes running totals for DECtape, 
Magtape, disk and bus errors. Examples of logged errors are: disk 
hardware failure, DECtape OFF LINE, magtape read error, etc. This 
data is stored in locations that are part of the System Table (Table 
5-1). The occurrence of these errors is normally transparent to the 
individual jobs (users), because the operating system always makes a 
number of attempts to successfully perform the operation that caused 
the error. Each unsuccessful attempt is logged in the System Table by 
incrementing the appropriate table entry. 


The number of retries for any particular device is fixed (refer to 
Chapter 3 in the MUMPS-11 Programmer's Guide). Once this limit is 
exceeded, the appropriate operating system error message is generated 
(see Section C.4). In addition to mass storage error data, the system 
also maintains a count of the number of illegal hardware interrupts. 
The occurrence of the error messages may be due to: 


1. Operation of a device that is not logically part of the 
current system (not SYSGENed into the system) 


2. Interrupt conditions explicitly ignored by MUMPS-1l (see 
Section 5.3) 


3. An unstable hardware condition 


The hardware error statistics contained in the following System Table 
are not automatically reported to the system manager. This task is 
performed by the Caretaker System Utility program (CTK) and the 
Caretaker Reporter program (KTR), described in Chapter 6. The CTK 
program is designed to run as a background job in its own 0.75K word 
partition. It operates at 5-second intervals taking error statistics 
from the System Table and storing them as chronological data in the 
special +SYS system global described in Appendix F. The KTR program 
reports the data stored in +tSYS by CTK and provides a chronological 
report as the system's hardware error statistics. It is strongly 
suggested that the system manager include CTK and KTR as part of his 
application system. Though these errors are not fatal to _ the 
operation system, they can cause user program termination. A high 
frequency of these errors indicates a general hardware problem that 
should be remedied. KTR should be run periodically to monitor both 
the system error activity and the size of the +SYS global. 


Table 5-1 
System Table Error Statistics 


Mnemonic Location 


ILGINT SV ($V (44) +16) count of illegal interrupts 
MTERRS SV ($V (44) +102) count of magtape errors 


DTERRS SV($V(44) +104) count of DECtape errors 
RKERRS $V(S$V(44) +106) count of RK11 errors 
SV ($V (44) +108) disk address of latest error 
SV ($V(44) +110) always 0 
$V ($V (44) +112) error (status word) 


Mnemonic 


RFERRS 


RPERRS 


HTCST 
HTCCM 
HTCWC 
HTCBA 
HTCDT 


MTCS1 
MTCS2 
MTDS 
MTER 
MTTC 
PARERR 


RMERRS 
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Table 5-1 (Cont.) 
System Table Error Statistics 


$v ($V(44)+114) 
$V ($V (44) +116) 


$V ($V (44) +118) 


$V ($V (44) +120) 
$V ($V (44) +122) 


$V($V(44) +124) 


$v ($V (44) +126) 
$v ($V (44) +128) 


$V ($V (44) +192) 
$V ($V (44) +194) 
$V ($V (44) +196) 
$V($V(44) +198) 
$V ($V(44) +200) 


$V ($V (44) +220) 
$V ($V (44) +222) 
SV ($V (44) +224) 
$V (SV (44) +226) 
$V(SV(44) +228) 
$V ($V (44) +232) 


$v ($V (44) +233) 


$V ($V (44) +234) 


$V (SV (44) +236) 
$V ($V (44) +238) 
$V ($V (44) +240) 


$V (SV(44) +306) 
$v ($V (44) +308) 


$V ($V (44) +310) 


$V ($V (44) +312) 


count of RF1l errors 
low-order of disk address 
of latest error 
high-order of disk address 
of latest error 

error (status word) 

count of RH11/RJP04,05,06 
errors 

address of latest errors 
bits 0-3 : sector # 

bits 8-12: track # 

bits 0-8 : cylinder # 
bits 10-12: drive # 
error (status word) 

TJU16 Hardware Register 
control status register 
command register 

word count register 

bus count register 

data register 

TJU16 Hardware Register 
control status 1 register 
control status 2 register 
drive status register 
error register 

tape control register 
Group 0 11/70 cache error 
count 

Group 1 11/70 cache error 
count 

11/70 parity LOW error 
register 

11/70 parity HIGH error 
register 

11/70 parity memory system 
error register 

11/70 parity job hung # 
count of RK611/RK06 errors 
address of latest error 
bits 0-3: sector # 

bits 8-12: track # 
address of latest error 
bits 0-8: cylinder # 

bits 10-12: drive # 

error register (status word) 


5.3 ERRORS THAT CAUSE THE SYSTEM TO CRASH 


Errors in this category are often the most serious that can occur in 


the MUMPS system. 
MUMPS job processing. 
and hard crashes. 
hardware-detected error conditions. 
system that leaves 


crashes 


operating 


operable. 


These are errors that cause the termination of all 
There are two types of system crashes: soft 
A soft crash is caused by one of several 


This results in a shutdown of the 


the processor running and Mini-ODT 
A hard crash is caused by an undetected error condition and 
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results in a processor halt. Occurrence of either type of crash 
indicates an abnormal hardware or software operation that may require 
the assistance of DIGITAL service personnel. Anyone diagnosing errors 
of this type should have a working knowledge of MUMPS internal 
structure and operation, as well as the PDP-1ll hardware. In 
particular, the individual must comprehend the PDP-ll's interrupt 
processing system and its utilization of low memory for interrupt 
vectors. 


5.3.1 MUMPS Interrupt Vector Utilization 


MUMPS uses the TRAP instruction for all MUMPS program and system 
errors except for GARBO through GARB4. TRAPs employed are 104776 
(octal) through 104732 (octal), and correspond to returned SE values 
of 0 through -.38. The TRAP instruction vector (address 34 (octal)) 
is set up to transfer control to the MUMPS Error Processor in the 
Interpreter. Furthermore, memory location 0 is set up to contain the 
TRAP instruction (104735(octal)) for the NOTSY error. Undesired 
transfers of control to location 0 generate an operating system error 
rather than create a crash condition. Specifically, this scheme 
allows system crashes to be avoided when system object modules or 
MACRO-11 global references (i.e., assembly language context) are 
missing. The LINK program (during system build) stores a zero in the 
undefined global reference. For example, referencing a DECtape (e.g., 
A 55) when the DECtape driver module is not part of the system, 
produces a NOTSY error. 


Other low memory addresses with special use include: 


Octal Locations 40,42 Contain a JUMP to the system restart 
code in Exec. 


Octal Locations 44,46 Contain a JUMP instruction to transfer 
control to the system's "Write Crash 
Block" Routine. 


Octal Location 54 Contains a pointer to the base of the 
System Table. 


Octal Location 56 Contains a "BR ."  MACRO-11 instruction 
which implements a MUMPS soft crash 
condition. This enables the use of 
Mini-ODT after a system crash. All 
crash errors, at the completion of their 
processing, transfer control to location 
56 (octal). 


5.3.1.1 Interrupt Vectors Ignored by MUMPS 


Illegal interrupts are logged, but otherwise ignored by MUMPS. All 
unused interrupt vectors, i.e., low memory addresses up through 
location 700 (octal) with no associated devices, are set up to. be 
ignored by MUMPS should an interrupt occur. These interrupt vectors 
are set up to contain a pointer to the hardware error statistics 
routine in the operating system. This routine increments the illegal 
interrupt entry register in the System Table (Table 5-1). Normal 
system operation continues after the error condition is logged. 


1. This information can be found in the applicable PDP-1l Processor 
Handbook. 
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5.3.1.2 Interrupts Processed by MUMPS 


The following interrupts are processed by MUMPS and result in a_ soft 
crash: 


e Bus Timeout Error 

e Illegal Instruction Error 

e Memory Parity Error 

e Segmentation Error 

e Power Fail 
The first four interrupts above result in a small amount of system 
checking. The hardware priority is then lowered (to enable Mini-ODT) 


and control is transferred to location 56 (octal). In addition, a 
power failure causes an immediate trap to 56 (octal). 


5.3.1.3 Hard Crash Interrupts Set Up by MUMPS 


The following interrupts are set up to HALT the processor at the 
interrupt location, should an interrupt occur. 


e EMT Trap Instruction 

e Programming Interrupt Request 
e Op Code 000003 with T-bit set 
e Floating Point Exception 


Under normal MUMPS operation these interrupts should never occur. If 
one of the above does occur, the CPU or MUMPS software is not 
functioning properly. Refer to procedures in Section 5.3.3. 


5.3.2 Soft Crash 


As mentioned earlier, a soft crash is caused by hardware or software 
errors that are detected by the PDP-11l processor. When a soft crash 
occurs, all MUMPS operations, except Mini-ODT, cease; the Control 
Console RUN lamp remains ON, and the processor ADDRESS REGISTER 
displays 56 (octal). 


Location 56 contains a "BR ." MACRO-1l instruction that causes the 
processor to execute continuously that single instruction. This 
causes the job currently running (in the RUNQ) to be lost and the job 
performing disk I/O (DSIOBQ) to be suspended. 


NOTE 


Users with PDP-11/10 processors must 
depress the HALT switch on the console 
to observe whether a Soft Crash is in 
effect. Pressing the CONT switch 
resumes operation. 
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When a soft crash occurs, the system manager should first HALT the 
processor, then save the Crash Block. The Crash Block is a reserved 
disk/memory area that can contain vital system crash data. This 
includes the contents of all system queues, general registers RO 
through R7, and the System Stack. This Crash Block data is obtained 
by activating a special save routine embedded within MUMPS. This 
information facilitates in determining the cause of the crash. 


The save operation is initiated by starting the processor at location 
44 (octal), as follows: 


1. Press HALT 

2. Set the SWITCH REGISTER switches to 44 (octal) 
3. Press LOAD ADRS 

4. Raise HALT 

5. Press START 


When the Crash Block is saved, the processor returns control to 
location 56. The system manager should next attempt to resume MUMPS 
operation by performing a system restart (see Section 4.5.1). This 
will allow all jobs, except the job in the RUNQ, to resume operation 
without data loss. The job in the RUNOQ will be lost and the I/O 
devices owned by it at the time of the crash will be locked out of the 
system. Once the system is restarted, the SIF or SS System Utility 
Programs should be run to obtain the current system status data. 
Thereafter the DMP program should be run to obtain a Crash Block 
Analysis Report. The reports obtained from these programs should be 
saved to allow error diagnosis by a DIGITAL Software Specialist, 
should his services be required. Lost jobs and locked-out devices can 
be restored by reloading the system from the disk via the ROM 
bootstrap loader. 


eee Hard Crash 


A hard crash is the unconditional termination of all processor 
operations. This type of error condition occurs when the system 
inadvertently causes the processor to execute a HALT instruction 
(machine code 000000). This condition is caused by a hardware or 
software malfunction that results in the modification of the contents 
of one or more memory locations that contain the operating system. 
This error condition is identified by the abrupt termination of all 
system operations and the extinguishing of the processor's RUN light. 
Possible causes of this error condition include: 


e Improper use of VIEW command 

e Hardware failure 

e Operating System failure 

e HALT Console Switch being pressed 


e Interrupts described under Section 5.3.1.3. 
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When a hard crash occurs, the system manager should obtain the 
following information for use in diagnosing the cause of the error. 


e The address displayed in the processor's ADDRESS REGISTER 
(lights) 


e Contents of registers RO through R6 (word locations 777700 
through 777706 (octal) ) 


e Contents of the first five memory word locations 


(ascending order) beginning with the address contained in 
R6 


Once this data is recorded, the system manager may wish to attempt 


either to restart the system or to reload the system as discussed in 
Chapter 4. 
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6.1 INTRODUCTION 


The System Utility and Test Programs are a group of privileged access 
utility programs, available only to the system manager via the System 
UCI (UCI #1). These programs provide the facilities necessary for the 
day-to-day maintenance, modification and basic testing of the MUMPS 
operating system. The programs reside in the Program Directory of the 
System UCI (UCI #1) and, unlike Library Utility Programs, these 
programs can only be accessed from terminals logged in under the 
System UCI. 


In general, program operation can be initiated in one of two ways: 


1. A program can be loaded at log-in time by entering the name 
of the program after the UCI code. For example: 


Typing: 'SYS:NAM' in response to the sign-in directive 
loads and starts the program called NAM from the UCI SYS. 


2. A program can be CALLed after log-in. For example: 


Typing: '‘'CuusNAM' also loads and starts the program called 
NAM. 


The programs are completely interactive and prompt the desired set of 
responses. Unless otherwise specified, all user responses are 
terminated with a Carriage RETURN. 


General error checking is performed by all programs. If a user 
response is not one that the program expects, most of the programs 
will output the range or type of expected responses and then retype 
the question. If the user detects an error before the Carriage RETURN 
is typed, individual characters can be deleted using RUBOUT, or the 
entire line can be deleted with a CTRL/U. System errors, such as 
those caused by defective hardware or a device not ready, are terminal 
and end the program's operation. Generally it is necessary to restart 
the entire program. 


Several of the programs (DBT,MSP,RKC,SDP,%GP) can run only if no other 
job is running. In such cases, the program will instruct the user to 
set one or more SWITCH REGISTER switches to effect a system shutdown. 


When the program has determined that all other users have finished, it 
continues operation. Some of these programs can be operated only from 
the console terminal; if loading is attempted from other terminals, 
an appropriate message is output. 


SYSTEM UTILITY AND TEST PROGRAMS 


6.2 SYSTEM UTILITY PROGRAM DESCRIPTIONS 


The paragraphs that follow describe the functional and operational 
characteristics of the System Utility programs. Table 6-1 lists and 
summarizes the operation of each. 


Table 6-1 
System Utility Program Summary 


Broadcast 

Allows the system 
operator/manager to send a 
message to all or selected 
active user terminals. 


System Caretaker 
Monitors system hardware error 
status and stores the data in 
the +SYS system global. 


Date Set 
Sets the $D System variable to 
the current date. 


Disk Block Tally 
Calculates the number of disk 
blocks available for each disk 
unit, (logical and physical), 
updates Disk Storage Allocation 
Table, tallies and reports errors. 


Disk Block Dump 
Provides octal dumps of 
specified disk blocks or a 
report on the contents of the 
system's crash block. 


Caretaker Reporter 
Interprets and reports system 

error data stored by CTK in the 
4SYS System Global. 


Modify System Parameters 
Alters UCI codes, terminal device, 
multiplexer, and timing and disk 

parameters, magtape default mode. 


RK Disk Copy 
Used with RKO5 distribution to 

physically copy one RKO5 cartridge 
to another RKOS5. 


Restore Job 
Restores wait queue and I/O hung 
jobs to the system. 


Restore Terminal 
Releases terminal devices owned by a job. 
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Table 6-1 (Cont.) 
System Utility Program Summary 


Sequential Disk Processor 
Space Allocator/Deallocator 
Allocates and deallocates disk 
space used by the system's 
Sequential Disk Processor. 


System Information 
Provides the partition starting address and 
system status (calls SS 

program) and system partition 
size/assignments for each job. 


System Status 
Provides information about the 

current system users, their job 
status and device ownership. 


System Shutdown 
Instructs the operator how 
and when the system can be 
HALTed 


System Startup 
Initializes system after a 
bootstrap start from the disk. 


Time Set 
Sets the ST system variable to 
the current time. 


Global Place 
Positions a global ona 
specified disk and cylinder. 


6.2.1 BCS - Broadcast 


The Broadcast program allows the system operator to send messages to 
all or specified active terminals (excluding CPU-CPU devices) from the 
console terminal. The user can broadcast either a message of his 
choice or the standard warning message: 


<<SYSTEM SHUTDOWN IN n MINUTES--PLEASE LOG OFF>> 


Once running, BCS types the time, then requests the user to _ specify 
either the S option (shutdown message) or the M_ option 
(operator-specified message). It then requests the user to select the 
A option (output message to all terminals) or the S option (output 
Message to specified terminals). If output is to specific terminals, 
BCS reques<s the numbers of the terminals to which output is to be 
directed. Each number must be separated from the next by a comma (,). 


Once the options and terminals are selected, BCS either outputs the 


shutdown message, if selected, or types two left angle brackets on the 
console terminal and waits for the user to type in a message. 
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6.2.2 CTK - Caretaker 


The Caretaker is a program that retrieves and logs the data contained 
in various PDP-ll hardware error status registers. CTK stores the 
data starting at node 18 of the special system global +SYS that was 
created by SYSGEN. 


Appendix F shows the complete structure of +SYS. Data collected by 
CTK includes: 


e Date and time when the file was begun. 
e Date and time of the last entry. 
e Number of illegal interrupts. 
e Number of bus errors. 
e DECtape error status. 
e Magtape error status (either TM1l or TJUI16). 
e Disk system error status. 
CTK requires at least a 0.75K-word partition for operation. It 
consists of the main program CTK and the subprogram CKO. CTK is 
normally STARTed from the console terminal. A typical command string 
to begin operation is: 
Urs0uuSeuCTK (6) HeslesArs0./ 
Nee ee eee eee eee 
1 2 3 4 
1. Release principal I/O device for use by CTK. 
2. START CTK in a 0.75K partition. 


3. HANG for one second to allow CTK to finish its I/0 to the 
principal I/O device. 


4. Reassign principal I/O device (CTK does no further I/O). 


Once running, CTK allows the user to specify either the I (Initialize) 
or C (Continue) option, The I option causes CTK to wipe out 
previously saved +SYS data before running. The C option instructs CTK 
to continue entering data following the data entered the last time CTK 
ran. Once STARTed, CTK runs on 5-second intervals. The data saved in 
+SYS is interpreted and reported by using the KTR (Caretaker Reporter) 
program described in paragraph 6.2.6. 


Because CTK is continually adding data to +SYS, the user must 
periodically reinitialize +SYS to avoid using excessive disk space. 
This can be done by using the I option. The old data can be saved by 
using the %GP Library Utility Program described in the MUMPS-11l 
Programmer's Guide. 
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NOTE 


If SWITCH REGISTER switch 6 is used _ to 
shut down the system, CTK must be 
restarted. 


6.2.3 DAT - Set Date 


This program allows the user to set the $D System Variable to the 
current calendar date. When it is loaded and running, DAT requests 
the user to enter the date. The user should enter the date using the 
mm/dd/yy format (e.g., 7/4/76 = July 4 76). Once entered, DAT outputs 
the new contents of $D (via the %D Library Utility Program) for user 
verification, DAT performs error checking on input to determine 
correct value range and form. 


6.2.4 DBT - Disk Block Tally 


DBT is a program that assists the user in determining the integrity of 
the MUMPS disk data structure. DBT consists of the main program DBT 
and the subprogram TAL and KIL. The program provides diagnostic data, 
remedial assistance and storage allocation information. SWITCH 
REGISTER switch #4 must be set to 0 to allow the Garbage Collector to 
run. Specifically, it: 


e Verifies each bit map's summary count of available blocks by 
comparing it to the calculated number of available blocks. 


e Reports the summary count, the calculated count, and _ the 
number of blocks allocated for sequential disk processor use, 
as well as the error status for each bit map in each disk: 
system. 


e Removes bit maps with count discrepancies from the Disk 
Storage Allocation Table (DSKSAT) to prevent propagation of 
additional errors. 


e Updates the memory resident Disk Storage Allocation Table 
(DSKSAT) . 


e Enables the system's Garbage Collector routine to run _ which 
in turn causes a new image of the DSKSAT to be saved on the 
system disk. 


DBT allows the user to specify both the device on which its report is 
printed and whether the long or short form report is desired. The 
user can request DBT to tally any or all disk units in the system. 
Figure 6-1 shows a typical DBT report. DBT does not allow other jobs 
to be running during its operation. 
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DISK BLOCK TALLY 
DATE 29 AUG 73 TIME 7:55AM 


ENTER TERMINAL # (1,4-19,64-111) FOR TALLY OUTPUT: 1 
RAISE SWITCH REGISTER SW #6 


DO YOU WANT LONG FORM (RESULTS PER MAP) TALLY OUTPUT, 
OR SHORT FORM (RESULTS PER UNIT)? TYPE L OR S. L 
DO YOU WANT TO TALLY ALL DISKS (Y OR N)? Y 


DISK MAP SUMMARY CALCULATED AVAILABLE # OF 
/UNIT COUNT GLOBAL BLOCKS SDP BLOCKS ERRORS 


RK/O 2039 2039 0 

RK/0 2400 
RK/1 2400 
RK/1 2400 
RK 7200 


DISK BLOCK TALLY FINISHED. 


Figure 6-1 Example of DBT Output 


6.2.5 DMP - Disk Block Dump 


This program allows the user to dump specified blocks of any disk unit 
onto the line printer. Further, DMP can also perform an analysis of 
the system's crash block (described in Chapter 5) and output a special 
report describing the status of the MUMPS-11 System at the time the 
crash occurred. DMP consists of the main program DMP and the 
subprogram DCB. 


The program begins operation by requesting the user to specify the 
desired option: 


Y./ 
DUMP CRASH BLOCK (Y OR N) ? |N_/ 
The user can type: 


V7. to request a crash block analysis report to _ be 
output to a specified device 


NJ to request that specified blocks be dumped in 
octal to the line printer 


at to request that the crash block be dumped in octal 
to the line printer 
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If N is typed, DMP requests the user to specify the desired mode: 


Mode Description 
A ASCII mode causes each byte to be output as an 
ASCII character 
B Byte mode causes the octal value of each byte to 
be output 
H Hexadecimal mode causes each word to be output in 


hexadecimal radix 


[@) Octal mode causes the octal value of each word to 
be output 


Any one or all of the modes can be specified in any combination. When 
more than one output mode is selected, commas must be used to separate 
each mode option. If no response is made within 20 seconds, the crash 
block is automatically output to the line printer in octal mode. 
Figure 6-2 shows a typical session requesting a crash block analysis 
report. Figure 6-3 shows a typical session requesting a disk block 
dump of RK disk unit 0, block 0 in all modes. Figure 6-4 shows a 
typical session requesting a memory dump from memory locations 1200 to 
1300 (octal). The relative block address (octal) precedes each line 
of 16 words. 


Before branching to location 56 on an error (location 56 contains a 
"BR ." instruction), the system usually saves certain information on 
the system stack. This information consists of the current 
instruction address when the trap occurred, the then-current PSW, and, 
finally, a sequence of words which depends on the type of error that 
occurred. 


Following are examples of some errors for which a column of words are 
stacked: 


11/70 parity error: Address when interrupted 
old PSW 
memory system error register 
low address error 
high address error 


11/45 parity error: address when interrupted 
40 old PSW 
bank number of parity error 
bus errors: address when interrupted 
old PSW 


address when interrupted 


Note that on a parity error, the last stacked word will be a= small 
number (<16), whereas a bus error will result in a much larger last 
word, which is also the same as the second previous word. 
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>C DMP 
DUMP CRASH BLOCK (Y OR N)? Y 


TYPE IN TERMINAL # FOR REPORT LISTING: 1 


SYSTEM CRASH BLOCK ANALYSIS 


DATE BLOCK RECORDED: 29 AUG 73 TIME BLOCK RECORDED: 9:25AM 


REGISTER CONTENTS AT TIME OF CRASH: 
RO R1 R2 R3 R4 R5 R6 R7 
120276 120330 127770 000001 120000 000044 000754 120004 


CONTENTS OF SYSTEM QUEUES AT TIME OF CRASH 
RUNQ SHORTQ DKIOBQ DKRSBQ RNGBQ BFRSBQ 
006014 052000 053000 054000 055000 056000 

WAITIQ WAIT2Q WAIT3Q CLOCKQ PAVLQ 
057000 060000 061000 062000 005004 


SYSTEM STACK ENTRIES AT TIME OF CRASH 

LOCATION CONTENTS 

000754 *120276 

000756 *120004 

000760 *000004 

000762 000000 

000764 040000 

000766 000000 

000770 067400 

000772 026364 

000774 023120 

000776 120270 

ENTRIES PRECEDED BY * WERE PUT ON STACK BY SYSTEM AT TIME OF CRASH 


SYSTEM STATUS AT CRASH TIME 
NUMBER OF ACTIVE JOBS -- 1 NUMBER OF AVAILABLE JOBS --7 
JOB NUMBER STATE DEVICES OWNED 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
IN RUN Q 
AVAILABLE FOR USE 
AVAILABLE FOR USE 


OANHDU SF WNE 


Figure 6-2 Example of DMP's Crash Analysis Report 
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>C DMP 
DUMP DISK BLOCKS OR MEMORY (D OR M)?D 
DUMP CRASH BLOCK (Y OR N)? N 


ANSWER THE FOLLOWING APPROPRIATELY: 
DISK? RK UNIT? 0 BLOCK? 0 


TYPE MODES (A[SCII],B[YTES],H[EX],O[CTAL]), SEPARATED BY COMMAS:A,B,H,O 


OUTPUT DEVICE #: 1 
OCTAL CONTENTS OF DISK BLOCK # 0 MODES: O RJ DISK, 
000000: = @ = @ = A = @ = B = Cc = 
021 300 013 340 035 301 000 300 020 102 025 303 377 000 
11¢c0 OBEO 1pcl 00cO 1024 15c3 FFOO 
010700 005740 016701 000300 010102 012703 177400 


-  - - J) - R - = = = E B - J 
012 203 005 375 000 162 000 030 000 005 145 302 000 312 
0A83 O5FD 0072 0018 0005 65C2 OOCA 
005203 002775 000162 000030 000005 062702 000312 


000020: 


- - - - - - = - = - 4H 
024 201 024 221 024 211 024 210 022 240 213 310 200 376 
1481 1491 1489 1488  12a0 8BC8 80FE 
012201 012221 012211 012210 011240 105710 100376 


000040: 


ry 


000060: - - - - - $ R - - = = = ¢ 
200 002 000 000 001 376 045 322 000 003 003 030 025 303 
8002 0000 = O1FE 25D2 = 0003 0318 15¢3 


100002 000000 000776 022722 000003 001430 012703 


Figure 6-3 Example of DMP'S Disk Block Dump 


UNIT O, 


024 021 
1411 
012021 


024 200 
1480: 
012200 


= P 
013 320 
OBDO 
005720 


T 

377 164 
FF74 
177564 
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>C DMP 

DUMP DISK BLOCKS OR MEMORY (D OR M)? M 
LOWER LIMIT(OCTAL)= 1200 

UPPER LIMIT(OCTAL)= 1300 


TYPE MODES (A[SCII],B[YTES] ,H[EX],O[CTAL], SEPARATED BY COMMAS:0 
OUTPUT DEVICE #: 


OCTAL DUMP OF MEMORY FROM 1200(OCTAL) TO 1300 (OCTAL) MODES: O 


001200: 002360 002236 001676 107260 002076 111020 111126 112000 
001220: 000000 000000 077540 105060 106060 177400 036017 002003 
001240: 000404 001057 113212 001200 112000 116000 172540 177400 
001260: 140060 160000 000154 177540 111400 000117 005140 047507 
001300: 000104 000000 000000 000000 000000 000000 000000 000000 
END OF DUMP 


Figure 6-4 Example of DMP'S Memory Dump 


6.2.6 KTR - Caretaker Reporter 


The Caretaker Reporter interprets and formats the error data stored by 
the CTK program in the special system global +SYS (see Section 6.2.2). 


The program allows the user to select either the line printer or the 
terminal as the output device. Figure 6-5 shows a typical KTR report. 
KTR operates only if nodes 18 through 60 of the +SYS global (described 
in Appendix F) contain data. This means that CTK must have run at 
some time prior to KTR's operation. 
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>C KTR 


TYPE P OR T FOR PRINTER OR TERMINAL: T 


SYSTEM ERROR STATUS 
21 MAY 75 3:03PM 
START START LATEST LATEST # ILLEGAL # BUS 
DATE TIME DATE TIME INTERRUPTS ERRORS 
21 MAY 75 2:55PM 21 MAY 75 3:03PM 0 0 
MAGTAPE (TM11) ERROR COUNT: 2 
100000 
160204 
177001 
066701 
006015 
100000 
TIME* 2:55PM 


DECTAPE ERROR COUNT: 2 


DISK ERRORS 


RK11 NO ERRORS 


RK611/RH11 NO ERRORS 


MOST RECENT ERROR 


Figure 6-5 Example of KTR Report 
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6.2.7 MSP - Modify System Parameters 


The MSP Program allows the system manager/operator to alter many 
system parameters without having to perform a new system generation 
via SYSGEN. The program consists of the main program MSP and 
subprogram modules MSU, %MU, MUX, MBP, MMD, and KIL. MSP permits the 
user to modify any of the four basic system parameter groups: 


e UCI Data and PAC. 
e Terminal Device Data (type, speed, tied or untied, etc.). 
e Multiplexer Line Conditioning (parity, speed, etc.). 


e Basic System Parameters (time slice, stack limit, line 
frequency, and disk control). 


e Magtape Default Mode. 


The program can be run only at the console terminal. It does not 
allow other users to be running at the same time. MSP performs part 
of the system generation process; detailed descriptions of its 
questions and appropriate user responses can be found in Chapter 3. 


When MSP completes its operation, it requests the user to save _ the 
newly modified system on its system disk by starting up the system's 
save routine from location 50(8). Thereafter, the user should make a 


backup copy of the system disk with the Backup program, (see Chapter 
4). 


6.2.8 RKC - RK Copy 


This utility is used in the RKO05 distribution to physically copy one 
RKO5 to another. This physical copy takes about 5 to 10 minutes. 


PHYSICAL COPY FROM RKO5 DRIVE: 


Enter the appropriate drive number. A null response will result in 
an exit from this program. 
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PHYSICAL COPY TO RKO5 DRIVE: 


Enter the appropriate drive number. An invalid drive number will 
result in the reasking of the previous question. 


LOAD THE DRIVES WITH THE DESIRED PACKS WHEN THEY ARE READY, TYPE <CR> 


Mount the desired packs on the selected drives. When they are ready, 
type a carriage-return. 


Figure 6-6 illustrates the use off RKC. 
RAISE SWITCHES 4 & 6 
PHYSICAL COPY FROM RKO5 DRIVE: 0 
TO RKO5 DRIVE: 1 
LOAD THE DRIVES WITH THE DESIRED PACKS 
WHEN THEY ARE READY, TYPE: READY 
READY 
*** PINAL CHECK *** 
COPY RK DRIVE 0 TO RKO5 DRIVE 1 
IF THIS IS CORRECT, TYPE : YES 
YES 
COPY STARTED 


COPY COMPLETED 


RESTORE THE MASTER PACKS TO THE APPROPRIATE DRIVES 
WHEN THEY ARE READY, TYPE: READY 
READY 


LOWER SWITCHES 4 & 6 
IF DESIRED, CALL CTK TO RESTART THE CARETAKER 


> 


Figure 6-6 Example of RKC Dialogue 


The program prints the pertinent information as a final check, and 
then asks if the information is correct. Any response other than YES 
will-abort the copy without any disc transfers, and control will be 
returned to the first question. If the user answers YES, the copy is 
performed. After the copy is completed, the message 


ALL DONE 


is typed. 
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NOTE 


The program RKC can only be run from the 
console. All other users should be 
signed off before running RKC. 


6.2.9 RSJ - Restore Job 


This program allows the system manager to restore a job, and the I/0 
devices owned by it, to the system. RSJ restores jobs that are 
reported by the System Status Program (SS) to be in a Wait Queue or in 
an I/O Hung state. Jobs that are "in transition" cannot be restored. 
The program is particularly useful for releasing jobs that are "lost" 
during a system crash, jobs that are accidentally STARTed, and jobs 
that are inactive because a user failed to log out. 


Once running, the program identifies itself and asks the user if he 
wishes to run the SS program to determine the number of the job to be 
restored. RSJ then either runs SS or requests the number of the job 
to be restored. When restoration is complete, RSJ prints a message to 
this effect then halts. Figure 6-7 shows an example of a typical 
session at the terminal using RSJ. 


>C RSJ 


UTILITY TO RESTORE A USER-SPECIFIED JOB 
AND RELEASE ALL DEVICES USED BY THE JOB 


DO YOU WISH TO RUN SYSTEM STATUS 
TO DETERMINE YOUR JOB NUMBER? (Y OR N): Y 


SYSTEM STATUS 


DATE--10 OCT 74 TIME--2:55PM 

NUMBER OF ACTIVE JOBS -- 3 NUMBER OF AVAILABLE JOBS --6 

JOB NUMBER STATE DEVICES OWNED 
1 IN CLOCK Q 

AVAILABLE FOR USE 

IN RUN Q 

TERMINAL I/O HUNG 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 


2 
3 
4 
5 
6 
7 
8 
9 


TYPE IN JOB NUMBER TO BE RESTORED:4 
YOUR JOB IS BEING RESTORED 
> 


Figure 6-7 Example of RSJ Session 
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6.2.10 RST - Restore Devices 


This program restores to the system the I/O devices that were owned by 
the jobs in the Disk I/O Bound Queue and the Run Queue. In addition, 
the program can release any device owned by a job in a _ normally 
running system. However, this should be limited to terminal type 
devices that are not currently active. 


DECtape and magtape devices can also be released, but to do so may 
endanger the device's file structure or data. Further, a job's 
Principal I/O Device should never be released, for this denies a user 
the ability to communicate with his job. Once this is done, the job 
can be stopped only by using the Restore Job Program (RSJ). 


After identifying itself, RST begins operation by requesting the user 
to specify whether an explanation of the program's options is desired. 


LONG FORMAT (EXPLANATION) OR SHORT (TYPE L OR S) ; ged) 
Then the program requests the option to be used: 
ALL 
oprron? | psx |-” 
nn 
The user can type: 
ALL to return all devices owned by the jobs in the Run 


Queue and Disk I/O Bound Queue at the time of a 
system crash. 


RUN to return all devices owned by the job in the Run 
Queue at the time of a system crash. 
DSK to return all devices owned by the job in the Disk 
I/O Bound Queue at the time of a system crash. 
nn to return one or more devices owned by the job 
: with the number (nn). If this option is selected, 


RST requests the number(s) of the device(s): 


ALL 
DEVICE(S) ? Be 
nn ‘a 
The user can type: 
ALL to return all devices owned by the job except its 
Principal I/O Device. 
nn to return one or more selected devices. 
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When the program completes the requested operation, it prints the 
message: 


REQUESTED DEVICES RETURNED 


then calls the System Status Program (SS) to present the current 
device status. Figure 6-8 shows an example of a typical RST session. 


>C RST 


UTILITY TO RETURN DEVICES TO SYSTEM 
LONG FORMAT (EXPLANATION) OR SHORT? (TYPE L OR S) L 


OPTION(S) TO BE INPUT: 

ALL - RETURNS DEVICES OWNED BY JOBS IN RUN QUEUE AND DISK 1/0 
BOUND QUEUE SUBSEQUENT TO SYSTEM CRASH 

RUN RETURNS DEVICES AFTER CRASH FROM JOB IN RUN QUEUE AT CRASH TIME 

DSK RETURNS DEVICES AFTER CRASH FROM JOB IN DISK I/O BOUND QUEUE 
AT CRASH TIME 

NN RETURNS DEVICES FROM JOB NUMBER (NN) 
PROMPTS A QUESTION AS TO WHICH DEVICES FROM THE STATED JOB 
SHOULD BE RETURNED. TYPE IN DEVICE NUMBERS, SEPARATED 
BY COMMAS (<CR> ENDS LIST), OR TYPE ‘ALL' TO GET BACK ALL 
DEVICES OWNED BY THAT JOB. 

OPTION? 2 


DEVICE(S)? ALL 


REQUESTED DEVICES RETURNED 


SYSTEM STATUS 
DATE--10 OCT 74 TIME--3:02PM 
NUMBER OF ACTIVE JOBS -- 4 NUMBER OF AVAILABLE JOBS --5 
JOB NUMBER STATE DEVICES OWNED 
IN CLOCK Q 
TERMINAL I/O HUNG 
IN RUN Q 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
AVAILABLE FOR USE 
TERMINAL I/O HUNG 
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Figure 6-8 Example of RST Session 
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6.2.11 SDP - Sequential Disk Processor Space Allocator and 


Deallocator 


SDP provides the user with the ability to allocate and deallocate disk 
blocks to be used by the MUMPS Sequential Disk Processor. The program 
consists of the main program SDP and subprograms SDl, SD2, SD3, KIL 
and TAL. During allocation, SDP reserves unused global’ and program 
storage blocks available to MUMPS. Blocks that contain global or 
program data (as opposed to SDP data) cannot be allocated. The 
deallocation process is the reverse of allocation. SDP allocates and 
deallocates blocks on disk units in multiples of the number of blocks 
available to a MUMPS bit map for a given disk type. The user 
specifies the disk type, the disk unit, the bit map at which 
allocation or deallocation is to begin, and the number of Maps to be 
processed. The program validates the format and content of each 
request so that the existing global data base or sequential data base 
will not be adversely affected. 


If a request is granted, the user is told specifically which unit and 
how many blocks have been affected. If a request is denied, the user 
is told specifically which MUMPS bit map or sequential data base is 
the cause. SDP accepts multiple requests for multiple disk types. It 
provides a summary for each disk type at the end of each session, 
showing the number of disk blocks affected. Table 6-2 shows the 
number of blocks available for each type of disk unit. 


Table 6-2 
Disk Block Allocation 


Disk No. of Maps Blocks 
Type Units Per Unit Per Map 
2 


Disk 
RK11 2400 
RF11 1024 
RS11 2048 
RK611 528 
RP11 (RP0O2,03) 200/200 
RH11 (RPO4,05,06) 418 


Blocks Per 
Unit Type 


4800 
1024 
2048 
26,928 
40,000/80,000 
170,544 


51 
200/400 
408 


Since SDP's operation involves manipulation of the system's file 
structure, it cannot be run while other jobs are running. Once 
loaded, it begins an interactive session with the user. Each command 
line must be terminated with a Carriage RETURN. Multiple commands can 
be entered on the same line by separating them with commas. 


The correct format for entering a command is: 
disk type: unit no.: map beginning: no. of maps 
Where: disk type = RK, RF, RS, RM, RP, or RJ 
unit no. = 0-7 
map beginning = map number of first map in a contiguous series 


no. of maps = the number of contiguous maps in the series 
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NOTE 


Because an RM disk unit has only one bit 
map per unit, the “map beginning" and 
"no. of maps" entries should not be 
specified. 


Figures 6-9 and 6-10 show typical SDP deallocation and allocation 
sessions. 


>C SDP 


DO YOU WANT LONG OR SHORT FORM OUTPUT - TYPE L OR S:L 
DO YOU WANT TO ALLOCATE OR DEALLOCATE SDP SPACE - TYPE A OR D:D 


SEQUENTIAL DISK PROCESSOR DEALLOCATION 

TYPE IN THE DISK TYPE:UNIT NO. :MAP BEGINNING:NO. OF MAPS 
FOR RM TYPE ONLY RM:UNIT NO. 7 

SEPARATE EACH REQUEST WITH A COMMA (,) END LINE WITH <CR> 
RM:0,RK:0:0:1,RP:0:8:1 


RM UNIT 0 IS SDP SPACE, CAN BE RESET FOR MUMPS FOR 1024 BLOCKS 


RK UNIT 0 MAP NO. 0 IS NOT SDP SPACE, CAN NOT DEALLOCATE 
THE REQUEST FOR RK:0:0:1 DENIED. 


RP UNIT 0 MAP NO. 8 IS SDP SPACE, CAN BE RESET FOR MUMPS FOR 200 BLOCKS 


TOTAL OF 1024 RM BLOCKS RETURNED 
TOTAL OF 200 RP BLOCKS RETURNED 


TOTAL OF 1224 DISK BLOCKS RETURNED 
DO YOU WANT TO RUN SDP AGAIN - TYPE Y OR N:N 
YOU MAY RUN DBT TO REVIEW THE NEW DISK STRUCTURE 


> 


Figure 6-9 Example of SDP Deallocation Session 
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>C SDP 


DO YOU WANT LONG OR SHORT FORM OUTPUT - TYPE L OR S:L 
DO YOU WANT TO ALLOCATE OR DEALLOCATE SDP SPACE - TYPE A OR D:A 


SEQUENTIAL DISK PROCESSOR ALLOCATION 

TYPE IN THE DISK TYPE:UNIT NO. :MAP BEGINNING:NO. OF MAPS 
FOR RK TYPE ONLY RM: UNIT NO. 

SEPARATE EACH REQUEST WITH A COMMA (,) END WITH A <CR> 
RM:0,RP:0:13:1,RK:0:0:1 


SPACE FOR SDP ALREADY ALLOCATED ON RM UNIT 0 


SPACE FOR SDP CAN BE GIVEN AS REQUESTED RP UNIT 0 MAP NO. 13 FOR 200 BLOCKS 


CANNOT ALLOCATE MAP 0 OF SYSTEM DISK! 

TOTAL OF 200 RP BLOCKS GIVEN 

TOTAL OF 200 DISK BLOCKS GIVEN 

DO YOU WANT TO RUN SDP AGAIN = TYPE Y OR N:N 
YOU MAY RUN DBT TO REVIEW THE NEW DISK STRUCTURE 


> 


Figure 6-10 Example of SDP Allocation Session 
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6.2.12 SIF - System Information 


This program provides both system partition and system status 
information. The partition data is obtained from the system's 
Partition Available Table while system status data is provided by the 
SS program which is called by SIF. Both system status and partition 
information is reported in a tabular format via the currently ASSIGNed 
I/O device. Figure 6-11 shows a typical SIF report. The user should 
refer to Section 6.2.13 for a description of the System Status report. 
The partition information part of the report is self-explanatory. 


SYSTEM INFORMATION 


SYSTEM STATUS 


DATE--28 MAY 75 TIME--11:49AM 

NUMBER OF ACTIVE JOBS -- 2 NUMBER OF AVAILABLE JOBS --9 
JOB NUMBER STATE DEVICES OWNED 
IN CLOCK Q 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

IN RUN Q 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 

AVAILABLE FOR USE 


1 
2 
3 
4 
5 
6 
7 
8 
9 
1 
1 


STANDARD PARTITION SIZE 8192 BYTES 


JOB NUMBER PARTITION SIZE START ADDRESS 
1536 BYTES 133632 
8192 BYTES 188416 
8192 BYTES 188224 
8192 BYTES 172032 
8192 BYTES 163840 
8192 BYTES 155648 
4096 BYTES 151552 
4096 BYTES 147456 
4096 BYTES 143360 
4096 BYTES 139264 
4096 BYTES 135168 


RPrRWOOWNAUPWNE 


Figure 6-11 Example of SIF Report 
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6.2.13 SS - System Status 


This program provides status information on all jobs in the system. 
The job information is obtained from the various system tables and 
queues in a "snapshot" manner. The data is interpreted and 
subsequently reported on the currently ASSIGNed I/0 device. The 
report itself is in tabular form, consisting of three columns of data. 
Figure 6-12 shows a typical example of an SS report. 


MUMPS INITIALIZER 


THE SYSTEM WAS LAST SAVED ON 30 JAN 77 AT 7:25 PM 


TYPE IN DATE MM/DD/YY 1/30/77 NEW DATE 30 JAN 77 
TYPE IN TIME HH:MM 19:26 NEW TIME 7:26 PM 
EXIT 


Figure 6-12 Example of SS Report 


The following paragraphs describe the responses that can appear in 
each column. 


6.2.13.1 JOB NUMBER 
This number identifies a user-initiated task (e.g., logging in, 


STARTing a program). There is a corresponding job number for each 
partition in the system. 


6.2.13.2 STATE 


Entries in this column specify the status of each job. The user 
should remember that when this information is printed out, it is not 
necessarily the system's status at the time of printing, for a certain 
amount of time is required to compile the data. There are fourteen 
possible job status states: 


DISK I/O DONE The job has just completed a 
logical disk access. A job 
having this status has the 
highest execution priority. 


DISK I/O BOUND The job is currently 
performing a logical. disk 
access (e.g., accessing a 
global node). 


DISK RESOURCE BOUND The job is currently waiting 
to use the disk. 


RING BUFFER RESOURCE BOUND Q The job is currently waiting 
to obtain a 64-character ring 
buffer. If several jobs are 
listed with this status, it is 
likely that a new SYSGEN 
should ~ be performed to 
allocate more buffer space. 
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256-WORD BUFFER RESOURCE BOUND Q 


HI PRIORITY WAIT Q 


MED PRIORITY WAIT Q 


LOW PRIORITY WAIT Q 


IN CLOCK Q 


TERMINAL I/O HUNG 


CARD READER I/O HUNG 


DECTAPE I/O HUNG 


MAGTAPE I/O HUNG 


IN TRANSITION 


AVAILABLE FOR USE 


The job is currently waiting 
to obtain a buffer in 
preparation for DECtape, 
Magtape, VIEW or SDP I/O. 


The job is currently waiting 
to run (next in priority after 
Disk I/O jobs are done). Jobs 
in this queue are given one 
CPU time slice. 


The job is currently waiting 
to run (next in priority after 
high priority jobs). Jobs in 
this queue are given two CPU 
time slices. 


The job is currently waiting 
to run (next in priority after 
med-priority jobs). Jobs in 
this queue are given three CPU 
time slices. 


The job is waiting for a time 
period to expire (e.g., timed 
READ, HANG or other 
significant event). 


The job is currently waiting 
for completion of I/O 
operation to a terminal device 
(devices 1,4-19, 64-111). 


The job is currently waiting 
for completion of I/O 
operation to a card reader 
(devices 51-54). 


The job is currently waiting 
for DECtape I/O to complete. 


The job is currently waiting 
for magtape I/O to complete. 


The job was not found in any 
queue. 


This message is 
self-explanatory. 
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6.2.13.3 DEVICES OWNED 


This column lists the numbers of the I/O devices owned (ASSIGNed) by 
the job. 


6.2.14 SSD - System Shutdown 


In order to assure that data base integrity is maintained, it is 
important that the MUMPS-1l System is HALTed only after all jobs have 
signed off. An abrupt system HALT can cause user files and, more 
importantly, the disk data structure to be seriously degraded. SSD 
aids the operator in performing an orderly system shutdown by 
providing the step-by-step procedures to bring the system toa 
quiescent state with all users signed off. 


SSD can be run only from the system's Console Terminal; an attempt to 
run from another terminal results in an appropriate message. Once SSD 
is running, it types a series of messages that specify the procedures 
the operator must follow. Figure 6-13 shows a typical operating 
session. If other users' jobs are running, the program then outputs a 
system status report (SS program) so that the operator can tell 
exactly which users' jobs are still running. If requested, SSD will 
update this report at specified intervals. Once all users have signed 
off, SSD will run the DBT program, if requested, to allow the operator 
to validate all disk structures. When SSD has completed its 
operation, it types EXIT, then’ stops. The system is ready for 
shutdown and the operator can now press the console's HALT switch. 
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** * SYSTEM SHUT DOWN * * * 


DATE -- 20 MAY 75 TIME -- 12:16PM 


NOTE: IF TERMINAL USERS DO NOT COOPERATE IN GETTING OFF THE SYSTEM, 
RAISE SWITCH REGISTER SW #15 AND WAIT 30 SECONDS, OR UNTIL THE ADDRESS 
REGISTER LIGHTS HAVE SETTLED. THEN RAISE SW #4. AFTER SEVERAL 
SECONDS (GARBAGE COLLECTOR FINISHES UP IF THERE WERE. BLOCKS TO 
COLLECT) YOU MAY HALT THE MACHINE. 


RAISE SWITCH REGISTER SW #6 


RUN DISK BLOCK TALLY (Y OR N)?Y 


DISK BLOCK TALLY 
DATE 20 MAY 75 TIME 12:16PM 


ENTER TERMINAL # (0-19,64-95) FOR TALLY OUTPUT: 0 

DO YOU WANT LONG FORM (RESULTS PER MAP) TALLY OUTPUT, 
OR SHORT FORM (RESULTS PER UNIT)? TYPE LORS. L 
DO YOU WANT TO TALLY ALL DISKS (Y OR N)? Y 


DISK MAP SUMMARY CALCULATED AVAILABLE # OF 
/UNIT COUNT GLOBAL BLOCKS SDP BLOCKS ERRORS 


MAPO = RK/0 1698 1698 0 
MAP1 = RK/0 2053 | 2053 0 
RK 3751 — 3751 0 


DISK BLOCK TALLY FINISHED 


RAISE SWITCH REGISTER SW #4 TO DISABLE GARBAGE COLLECTOR 


SYSTEM SHUTDOWN COMPLETED AT 12:17PM ON 20 MAY 75 


YOU MAY HALT THE MACHINE AFTER 'EXIT' 
IF PHYSICAL DISK SAVE(S) DESIRED, BOOT BACKUP PROGRAM. 


EXIT 


Figure 6-13 Example of SSD Session 
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6.2.15 STU - System Startup 


STU is an initialization program that automatically runs whenever 
MUMPS is loaded from the disk and started using the bootstrap loader 
(see Section 4.5.2). Once running, the program prints the date and 
time of the last system save operation (see Section 4.4.3), calls the 
Date and Time routines (%D and $%T), starts the system Caretaker 
program (CTK), then halts. If the user does not want CTK to run, it 
can be stopped by raising SWITCH REGISTER SWITCH 12 for 10 seconds. 


Since program operation is inherent in system initialization via the 
bootstrap loader, the system library must always contain a program 
called STU. Users not wishing to use this program should create their 
own version even if it consists of a HALT instruction only. 

Figure 6-14 shows an example of STU operation. The user's responses 
are underlined. 


MUMPS INITIALIZER 


THE SYSTEM WAS LAST SAVED ON 5 NOV 74 AT 10:15AM 


TYPE IN DATE MM/DD/YY 11/6/74 NEW DATE 6 NOV 74 
TYPE IN TIME HH/MM 10:05 NEW TIME 10:05AM 
EXIT 


Figure 6-14 Example of STU Dialogue 


6.2.16 TIM - Set Time 


This program allows the user to set the $T system variable to the 
current time of day. When it is loaded and running, TIM requests the 
user to enter the time. The user should enter the time in 24-hour 
form (e.g., 07:30 = 7:30 A.M., 15:00 = 3:00 P.M., etc.). Once the new 
time is entered, TIM outputs the new contents of ST (using the $%T 
Library Utility Program) to allow verification. TIM performs error 
checking on input to determine correct value range and form. 


6.2.17 %GP - Global Place 


This program allows the user to position a new global on aé_e selected 
physical disk type and unit. In the case of RK11, RP11 or RH11 disk 
systems, the disk cylinder can also be selected (RK611 disks are not 
organized into cylinders). Its operation consists of: 


1. entering the global's name in the global directory of the 
current UCI, and 


2. allocating the first block of the global on the specified 
disk unit and cylinder, if applicable. 


Since the program's operation involves manipulation of the system's 
file structure, %GP does not allow other jobs to be running at the 
same time. Furthermore, the user must have access to the System UCI 
code to operate %GP. The program consists of the main program %GP and 
the subprogram %MU. 
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Once running, the program identifies itself, then requests the user to 
enter the system's UCI code. When the code is validated, %GP asks the 
user to quiet the system by using one or more specified SWITCH 
REGISTER switches. After all other users are logged out of the 
system, the program begins the global placement session with the 
question: 


xxx _/ 
GLOBAL? +] YYY_/ 
ae, 


The user can type: 

A new global name (xxx) 
to create a new global not currently residing under 
the current UCI. ‘ 

An old global name (YYY) 
to request the deletion of an existing global and 
the creation of a new global of the same name. 

_ to terminate program operation. 


If an old global name is entered, the program responds: 


4¥YY ALREADY EXISTS!! 


Y 
DO YOU WISH TO KILL THIS GLOBAL? (TYPE Y-OR N): wa? 
N 
The user can type: 
Y to delete the present global and create a new global 
with this name. 
N to restart GP so that another name can be used. 


GP then requests the name of the type of disk where the global is to 
reside: 


RK./ 
RF./ 
RS / 
DISK TYPE? RM./ 
RP _/ 
RJ./ 
The user can type: 
RK to specify the RKO3 or RKO5 on the RK11 
RF to specify the RS11 on the RFI11 
RS to specify the RS04 on the RH11 
RM to specify the RKO6 on the RK611 
RP to specify either the RP02 or RPO03 disk on the 


RP11 controller 


RJ to specify either the RP04, RPO5 or RP06 disk on 
the RH11 controller 
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CARRIAGE 

RETURN to specify automatic allocation of the global to 
the system disk (the next two questions are 

(./) skipped). 


Thereafter, the program requests the unit number of the specified 
disk. 


UNIT? n_/ 


The user can type any number (n) in the range O through 7 that 
specifies a disk unit that exists in the system. 


If the disk that was selected is an RK11, an RP1l, or an RH11l (RJ), 
%GP requests the number of the cylinder where the global is to reside: 


nnn 
CYLINDER? | _/ 
The user can type: 

cylinder number (nnn) to specify the disk cylinder where 
the global is to begin. %GP will 
attempt to place the first block of 
the global on this cylinder, or if 
full on the next (higher) 

cylinder. ! 
ae" to request block placement on 


cylinder zero (0) or if full, on 
the next available cylinder. 


GP reports the results of each successful placement session in the 
following form: 


(dknz:nn mmm) 


where: dkn = disk type and unit number 
(e.g., RKO3) 


nn = cylinder number 


mmm = address of the disk block 
allocated as the global's first 
block. 


6.3 SYSTEM DEMO PACKAGE 


The system demo package is a group of eight separate test programs 
(TPl through TP8) that are designed to assist the system manager in 
verifying the integrity of the MUMPS-11 operating system and language. 
These programs are particularly useful for verifying the system after 
a SYSGEN session or after field service hardware or software 
maintenance, 


As shown in Table 6-3, each program performs a group of tests’ related 
to a specific aspect of the system or language. The tests can be run 
either singly or in any desired combination. The TP7 program runs all 
programs in the test package, except TP5 and TP6, automatically. The 


1. Refer to the PDP-11l Peripherals and Interfacing Handbook 


for further information. 
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system test package is a first-level check to assure that a MUMPS 
hardware/software system is operational. It should be run when a 
system is installed and the output should be saved for subsequent 
checks if the system seems to be malfunctioning. 


Table 6-3 
System Test Package Programs 


Program Description 
Name 


MUMPS-11 Language Functions Test 
Verifies the operation of all functions in the language. 
(Creates tA global) 


System Timings Test 
Performs and reports timing measurements for arithmetic, 
global and symbol table routines. 

(Creates tA global) 


MUMPS-11 Expression Evaluate Test 
Verifies the operation of all expression evaluating tasks. 
(Creates globals: +tA,+B,+tC,+tD,tE,+T) 


Line Printer/Terminal Test 
Verifies operation of the line printer or any specified 
terminal. 


DECtape Test 
Verifies all DECtape functions and error conditions. 


TM11 Magnetic Tape Test 
Verifies all magtape functions and error conditions. 


System Exerciser Utility 
Runs all other test programs except TP5 and TP6 and 
performs its own abbreviated TMll magtape and DECtape 
tests. 


Global Test 
Builds a test global (+A) to check global routine 
operation. 
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Array An array, which can consist of either 
local or global variables, is a group of 
subscripted variables that have a common 
identifier. 


Binary Operator A binary operator is an operator that 
requires two operands (expression 
elements). 


Boolean Valued Expression A Boolean valued expression (bve) is an 
expression, which, when evaluated, 
produces either a True (-0.01) or False 
(0) result. 


Command A command is the principal algorithmic 
component of the MUMPS Language. MUMPS 
commands consist of a set of keywords 
that characterize actions. (e.g., GOTO, 
SET, HALT, RUN,etc.) 


Concatenation Concatenation is the process of linking 
together two or more string data 
elements to form a single string. 
Concatenation is a string expression 
operation that is designated by the 
commercial "at" sign (@). 


Constant ‘A constant is a quantity within the 
range of legal MUMPS numbers 
(+21474836.47) explicitly stated in an 
argument to a command or as an operand 
in an expression. 


Data Base Data base is that body of disk-stored 
information residing in global arrays. 

Direct Mode Direct mode is that mode of system 
operation which enables the programmer 
tos 


1. enter commands and/or functions’ for 
immediate execution 


2. create or modify steps of a user's 
program 


Directory A directory is a disk resident table 
which can contain the names and disk 
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Double Numeric Quantity 


Expression 


Expression Element 


Floating Point Numeric 


Function 


Global 


Global Variable 


Identifier 
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starting addresses of either programs or 


global files. Each User Class 
Identifier in a MUMPS-11 system is 
associated with two directories; a 
program directory, and a global 
directory. 


This term refers to MUMPS numbers whose 
absolute values lie in the range (+) 
21474836.47 which are stored by the 
operating system in two consecutive 
words. (See also Single Numeric 
Quantity.) 


An expression is any legal combination 
of operands (elements) and operators. 
Legal expression elements include: 
literals, constants, variables, 
subexpressions, and function references. 
An expression may consist of a single 
element, an element/operator combination 
or a series of element/operator 
combinations. 


An expression element is the operand 
component of a MUMPS expression. An 
expression element may be a constant, a 
simple variable, a literal, a local 
subscripted variable, a global variable, 
a function reference, or a 
subexpression. 


A 4-word floating point number in the 
range +0.14*10% to +1.7*10%. The 
MUMPS $M function allows floating point 
numbers to be used with the operators + 
- * / <> =. A floating point number may 
be stored only as a local variable which 
is not the name of an associated array 
(i.e., pointer variables are excluded) 
or as a global variable. 


A function is a MUMPS expression 
component that invokes an algorithm, the 
result of which is an expression element 
(operand). _Each MUMPS function is 
assigned a unique mnemonic, the first 
character of which is the dollar sign 
($) symbol. 


A global is a tree-structured data file 
stored in the common data base on the 
disk. Globals comprise an external 
system of symbolically referenced 
arrays. 


A global variable is a subscripted 
variable that forms an element (or node) 
of a global array. 


An identifier is a name consisting of 
one to three alphanumeric characters. 
The first character must be either an 
alphabetic character or the percent (%) 
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IF Switch 


Indirect Mode 


Indirect Reference 


Job 


Library Program 


Literal 


Local Variable 
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symbol. Identifiers are used as names 
for variables, programs, library (or 
system) programs, and globals. The 
percent symbol is reserved for naming 
library programs and globals, though any 
local variable can use percent as the 
first character of its name. 


The IF switch is a logical switch that 
resides in the Program Vector area in 
each user's partition. This switch is 
set to the logical result of the last 
executed IF statement, either True 
(-0.01) or False (0). Note that an IF 
without arguments or an ELSE only tests 
the logical value of the IF Switch and 
does not change it. 


Indirect mode is that mode of system 
operation in which the steps of a stored 
program are executed. In this mode of 
operation, commands cannot’ be entered 
from the terminal and programs cannot be 
created or modified. 


An indirect reference is a feature of 
the language that permits a_ string 
variable to represent a command's 
argument or argument list. In 
operation, the string value of the 
variable is taken as the argument or 
argument list. The indirection symbol, 
back arrow (+) or underscore (_), must 
precede the variable reference. 


A job is any user activity which 
requires the use of a partition. For 
example, logging or STARTing a program 
are jobs. 


This term refers to those programs’ that 
are listed in the Program Directory of 
the System UCI (UCI#1) and have a 
percent symbol (%) as the first 
character of their names. Programs 
residing in the system in this way can 
be run by any user regardless of UCI. 


A literal is an element of the language 
that permits the explicit representation 
of character strings in expressions, 
commands, and function arguments by 
delimiting them with quotation marks (" 
"). Literals may not contain: 


quotation marks CTRL O Line Feed 
Carriage RETURN CTRL C_ Form Feed 
ALT MODE CTRL U Vertical Tab 
RUBOUT (DEL) NUL CTRL S and Q 


A local variable is a variable that 
resides in the partition of the program 
that created it (as opposed to a global 
variable). 
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Naked Reference 


Node 


Numbers 


Numeric Valued Expression 


Operator 


Part Number 


Partition 


Pattern Verification 


Principal I/O Device 
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The naked reference is a feature that 
provides an abbreviated method for 
accessing global variables to reduce 
disk access time. This permits 
subsequent references to a global to be 
made simply by specifying an up-arrow 
(+t) followed by one or more subscripts. 
The variable name is assumed from the 
last global reference in which a name 
was explicitly stated. The first 
subscript in the naked reference 
replaces last subscript in the previous 
reference (either naked or complete). 
Using the naked reference reduces disk 
access time since the search for the 
specified node begins at the subscipting 
level attained by the last global 
reference rather than at the global 
directory level. 


A node is a global array element 
addressed by a subscript. 


Numbers in MUMPS are signed fixed-point 
quantities in the range +21474836.47. 
Decimal fractions greater than two 
places are truncated to two places. 


A numeric valued expression (nve) is an 
expression which, when evaluated, 
produces a numeric result. 


An operator is a component of a MUMPS 
expression that invokes an algorithm to 
perform either arithmetic, string, or 
Boolean Manipulators. (See binary 
operator and unary operator.) 


A part number is the integer portion of 
a step number and is used to refer 
collectively to all steps having a 
common integer base. 


A partition is the memory area within 
which a job resides. A partition is 
allocated to a job either at terminal 
log-in time or upon execution of the 
START command. A partition contains 
both program and local variable storage 
areas as well as program state 
information necessary for timesharing 
operation. 


Pattern verification is a feature of the 
language which permits evaluation of 
text strings for the occurrence of 
desired combination of alphabetic, 
numeric, and punctuation characters. 


Pattern verification is specified by the 
ae ci operator followed by Pattern 
Specification Codes (psc). 


This term refers to the keyboard 
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terminal that initiated the job. This 
is the device to which control returns 
when an error message is to be output or 
when an ASSIGNesO command is issued. 


Program Name A program name is an identifier that is 
associated with a particular program. 
System library program names must use 
the percent symbol (%) as_ the first 
character. 


Programmer Access Code The Programmer Access Code (PAC) is a 
3-character code, created at system 
generation time, that allows the 
terminal user to enter direct mode. 


Queue A queue is an ordered list in which the 
first item to be entered is the first 
item to be removed (first-in-first-out 
sequence). 


Run Queue The run queue is a system queue which 
contains the number of the job currently 
executing in its time slice. This queue 
is effectively a one-entry queue. 


Secondary Storage This term refers to all I/0 devices 
which are not used to contain the global 
data base (non-disk), (i.e., paper tape, 
Magtape, or DECtape). 


Single Numeric Quantity This term refers to MUMPS numbers in the 
range +327.67 which ‘are stored by the 
operating system in one 16-bit word. 
(See also Double Numeric Quantity.) 


Sparse Array A sparse array refers to the method of 
storage allocation used for local and 
global arrays in which space is 
allocated only as variables are 
explicitly defined (unlike other 
languages which require dimension or 
size statements for preallocation of 
storage). 


Step Number A step number is a number used to 
identify each line of a MUMPS program. 
A step number must be in the range 0.01 
- 327.67, excluding all numbers in this 
range that are integers. 


String A string is a contiguous combination of 
any of the ASCII characters. (132 
characters maximum). 


String Concatenation See Concatenation. 

String Valued Expression A string valued expression (sve) is an 
expression which produces a_ string 
result upon evaluation. 

Subexpression A subexpression is an expression element 


that consists of any legitimate 
expression enclosed in parentheses. 
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Subscripts 


Subscripted Variable 


System Program 


System Queues 


System UCI 


System Variable 


Time Slice 


Unary Operator 


User Class Identifier (UCI) 


A subscript is a numeric valued 
expression or expression element which 
is appended to a local or global 
variable name to uniquely identify 
specific elements of an array. 
Subscripts are enclosed in parentheses. 
Multiple subscripts must be separated by 
commas. 


A subscripted variable is a variable to 
which a subscript is affixed (see 
Subscript and Variable). Both global 
and local variables are forms of 
subscripted variables. 


A system program is a program either 
supplied by DIGITAL or created by the 
MUMPS user which is used to assist the 
MUMPS system owner in the operational 
Maintenance of the system. System 
programs normally reside under the 
protection of the System UCI (UCI #1). 


This term refers to the set of queues 
used by the MUMPS Operating System to 
control the allocation of system 
resources (see Run Queue and Wait 
Queue). 


The System User Class Identifier (UCI) 
code is that UCI code assigned to the 
first entry in the system's UCI table. 
The Program and Global Directories 
associated with the System UCI are used 
to contain both system and library 
programs and globals. 


A system variable is a variable that is 
permanently defined within the operating 
system. These variables provide system 
and control information to all programs. 
The first character of a system variable 
is always a dollar sign ($). System 
variables are maintained and modified by 
the operating system and/or system 
Manager only. 


This term refers to the period of time 
allocated by the operating system to 
process a particular partition's 
program. This term is synonymous with 
"timesharing interval’. 


A unary operator is an operator that 
requires a single operand (expression 
element). 


A UCI is a 3-character code used at 
terminal log-in time to permit access to 
the group of programs and global files 
with which it is associated. When used 
with the Programmer Access Code, the UCI 
allows these programs to be modified and 
new programs to be created. 
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Wait Queues 
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A variable is the symbolic 
representation of a logical storage 
location. Specific types include local, 
global, simple, and subscripted 
variables. Variables are symbolically 
referenced by means of identifiers. 


The wait queues are a group of system 
queues which contain the numbers of the 
jobs awaiting service by the operating 
system. 


APPENDIX B 


MUMPS CHARACTER SET 


The following table shows, with the corresponding octal and decimal 
equivalents, the 128-character set of 7-bit ASCII code used by MUMPS 
for data, command, and control purposes. In addition, the order of 
the character set as shown establishes the MUMPS collating sequence 
used by the system's Expression Evaluator when establishing string 
relationships. 


For command and control purposes, MUMPS uses the 64-character graphic 
subset. The system also uses the control codes shown in brackets 
({ ]). These codes may not be used as input data. The NUL, code 000, 
is used internally as a logical end-of-message and cannot be used. 
Characters shown in braces({}) are part of the 1963 ASCII Character 
Set and may appear in the character set of some terminals. 


All characters may be used for data input and output except for those 
mentioned above. The system does not perform any character 
conversion. It is the programmer's responsibility to perform all 
upper/lower-case letter conversions or mappings which are required for 
the particular application. 


CHARACTER SET 


Octal Code Decimal Code Character 
000 000 NUL 
001 001 SOH (Backspace) + 
002 002 STX (Forward space) + 
003 003 ETX (CTRL C)* (Write tape mark). 
004 004 EOT (Write Block) 
005 005 ENQ (Rewind) + 
006 006 ACK (Read block)+ 
007 007 BELL (Read Label) + 
010 008 BS* (Write header label)+ 
011 009 HT (Write EOF label)+ 
012 010 LF 
013 011 VT 
014 012 FF 
015 013 CR 
016 014 so 
[017 015 SI(CTRL O)*] 
020 016 DLE 
021 017 DCl 
022 018 DC2 
023 019 DC3 


+ Dagger denotes the control function for magtape devices. 
* Asterisk denotes the control function for MUMPS terminal, if 
different from specified or other use. 


B-1 


MUMPS CHARACTER SET 


CHARACTER SET (Cont.) 


Octal Code Decimal Code Character 
024 020 DC4 
[025 021 NAK (CTRL U)*] 
026 022 SYN 
027 023 ETB 
030 024 CAN 
031 025 EM 
032 026 SUB 
[033 027 ESC (ALTMODE) *] 
034 028 FS 
035 029 GS 
036 030 RS 
037 031 US 
040 032 Space 
041 033 i 
042 034 : 
043 035 # 
044 036 $ 
045 037 % 
046 038 & 
047 039 iW 
050 040 ( 
051 041 ) 
052 042 * 
053 043 + 
054 044 i 
055 045 - 
056 046 5 
057 047 / 
060 048 0 
061 049 1 
062 050 2 
063 051 3 
064 052 4 
065 053 5 
066 054 6 
067 055 7 
070 056 8 
071 057 9 
072 058 : 
073 059 ; 
074 060 < 
075 061 = 
076 062 > 
077 063 ? 
100 064 @ 
101 065 A 
102 066 B 
103 067 Cc 
104 068 D 
105 069 E 
106 070 F 
107 071 G 
110 072 H 
111 073 I 
112 074 J 
113 075 K 
114 076 L 
115 077 M 
116 078 N 


w 
' 
bo 


MUMPS CHARACTER SET 


CHARACTER SET (Cont.) 


Octal Code Decimal Code Character 
117 079 ie) 
120 080 P 
121 081 Q 
122 082 R 
123 083 Ss 
124 084 T 
125 085 U 
126 086 Vv 
127 087 Ww 
130 088 X 
131 089 Y 
132 090 Z 
133 091 [ 
134 092 \ 
135 093 ] 
136 094 or + 
137 095 —_ ee 
140 096 7 
141 097 a 
142 098 b 
143 099 c 
144 100 d 
145 101 e 
146 102 £ 
147 103 g 
150 104 h 
151 ; 105 i 
152 106 j 
153 107 k 
454 108 1 
155 109 m 
156 110 n 
157 111 ° 
160 112 p 
161 113 q 
162 114 r 
163 115 s 
164 116 t 
165 117 u 
166 118 Vv 
167 119 w 
170 120 x 
171 121 y 
172 122 Zz 
173 123 { 
174 124 q 
175 125 } = (ALTTMODE) * 
176 126 ~ (ALTMODE) * 
177 127 DEL (RUBOUT) + 


* Asterisk denotes the control function for MUMPS terminals, if 
different from specified or other use. 
+ Dagger denotes the control function for magtape devices. 
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EXPLANATION OF MUMPS MESSAGES 


When execution of a MUMPS program is terminated by either an error, a 
CTRL C, or by pressing the BREAK key, the program executive outputs a 
short message to indicate the reason for termination. This message is 
followed by the number of the Step being executed and the program 
name, unless the error occurred while in Direct Mode. The error 
message format is: 


?message>spntu4apnam 
MUMPS messages are categorized as follows: 


1. MUMPS Programming Error Messages - these result from errors 
associated with programming problems (either incorrect 
language syntax or semantic misunderstandings). 


2. Voluntary Program Termination Message - there is only one 
message of this type. 


3. Debugging Aid Message - this indicates that a BREAK command 
has been encountered in the program. 


4. Operating System Error Messages - these result from various 
troubles which are detected by the operating system and which 
are beyond the control of the MUMPS application programmer. 


MUMPS errors are considered terminal unless the user's program SETS 
the SE System Variable for application program control of error 
processing. The programmer may SET SE to a Step or Part number 
(SwuSE=spn) to which control will go if an error occurs (except GARBO 
- GARB4 errors are reported only on the console terminal and do not 
terminate a running job). When $E is set to an spn and an error 
occurs, the system transfers control to the spn and resets $E to an 
index in the range 0 through -0.38, which indicates the type of error 
encountered (e.g., 0 = INRPT, -0.01 = MXNUM - see below). The number 
of the Step that contains the error is entered in the $W System 
Variable. The system also cancels all currently active DO, FOR, and 
CALL commands. It is the user's responsibility to reset $E to an spn 
if he wishes to control further error processing; otherwise, error 
processing reverts to system control. 


If an error occurs and SE is not set by the programmer, the action 
taken by the system depends on the mode in which the user signed on at 
log-in. If the programming access code (PAC) was used, control is 
returned to Direct Mode after the error message is output. Otherwise, 
the job is aborted after typing the error and 'EXIT' messages, and the 
terminal is automatically logged-out. 


Each of the messages is explained on the pages which follow: 


EXPLANATION OF MUMPS MESSAGES 


C.1 MUMPS PROGRAMMING ERROR MESSAGES 


Message SE Index Meaning 


CMMND -0.15 Indicates illegal use of a command: 
1. Command is undefined in the language 


2. An argument has_- been omitted where 


required. 
DIVER -0.19 Indicates an attempt to perform division by 
zero. 
DKSER -0.04 Indicates (if not a system software error 


(C.4)), an attempt to: 


1. use the VIEW command to access a_ block 
number larger than the size of the 
referenced disk, or a nonexistent disk; 
or 


2. use the disk (e.g., creating global 
variables, issuing the FILE, LOAD, etc., 
commands) under a UCI that has no 
associated directories. 


FRACT -0.08 Indicates that a fractional number was 
encountered when the process being executed 
was expecting a integer number. Also 
involved when a Step number has no fractional 
part. 

FUNCT -0.07 Indicates that the function is undefined in 


the language. 


LBOV -0.14 Indicates an attempt to input or output a 
line greater than 132 characters. 


SMERR -0.36 Indicates that an error occurred in SM 
processing. 


1. exponent overflow 

2. exponent underflow 

3. division by 0 

4. illegal trap instruction (system error) 


MINIM -0.03 Indicates that a number has more than_ two 
digits following the decimal point. 


MINUS -0.12 Indicates that a negative or zero number was 
encountered when a positive number was 
expected. For example, MUMPS causes a MINUS 
error if the user references a subscripted 
variable with a negative subscript. Only 
positive subscripts are allowed, except when 
using the SHIGH function. 


Message 


MODER 


MXNUM 


MXSTR 


NAKED 


NODEV 


NOPGM 


NOTSY 
NXMEM 


PGMOV 


PROT 


SE Index 


-0.23 


-0.01 


-0.02 


-0.29 


-0.13 


-0.28 


-0.34 


-0.05 


-0.24 


-0.06 
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Meaning 


1. An nve was encountered where an svl was 
expected, or vice versa. 


2. Argument to STEXT is not numeric. 
3. Argument to SVIEW is not numeric. 


Indicates that the value of a number has 
exceeded the integer bounds set by the MUMPS 
system. The maximum value for a number is 
+21474836.47. 


Indicates that the string has exceeded 
maximum length allowed (132 characters). 


Indicates that the present user attempted to 
reference a global variable using "naked" 
syntax: 


l. prior to any full syntax reference; or 


2. after another user KILLed the global 
variable. 


Indicates an attempt to ASSIGN a nonexistent 
device or the use of an illegal device 
number. 


Indicates that reference is made to a program 
name that does not exist in the program 
directory for this UCI and is not in the 
Directory of Library (%) Programs. 


Indicates that the referenced device or 
function is not in the system (it may not 
have been linked at system generation). 


Indicates that nonexistent Memory was 
referenced in the VIEW command or in the 
SVIEW function. 


Indicates that there is insufficient space 
available in the partition. This can be 
caused by: 


1. too many program steps in the program 
being created via the terminal or in the 
program being loaded; (LOAD, CALL and 
OVERLAY commands) 


2. too many local variables; 
3. expression or subscript nesting too deep. 


Indicates that an attempt was made to use 
either the VIEW Command or the S$VIEW Function 
from a non-Library (%) Program or when not 
logged in under the System UCI. Also 
indicates that the MODIFY command issued from 
Indirect Mode specified an spn smaller than 
the current spn. 


Message SE 


SBSCR 


SPNER 


STKOV 


STKUN 


SYMOV 


SYNTX 


UNDEF 


C.2 VOLUNTARY 
Message SE 


INRPT 0 


C.3 DEBUGGING 
Message SE 


?n BREAK 


$E_Index 


-0. 


-0. 


-0. 


-0. 


-0. 


-0. 


-0. 


Index 


Index 


None 
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Meaning 
09 Indicates illegal subscript usage: 
- subscript out of range; 
- negative subscript. 

17 Indicates that an illegal or nonexistent Step 
or Part number was used. 

10 Indicates that the available stack space is 
used up. Generally indicates nesting is too 
deep in DO or CALL statements. 

11 Indicates execution of the Overlay command 
from Direct Mode (stack underflow). 

16 Indicates that Symbol Table Overflow occurred 
on an attempt to create or change a local 
variable. : 

27 Indicates that the current Step being 
executed has an error in syntax. - Syntax 
errors include illegal punctuation, illegal 
use of operators, illegal use of parentheses, 
as well as errors encountered in editing a 
Step. Syntax errors comprise a great 
majority of errors made in the MUMPS system 
and usually the user will be able to 
determine the exact cause of the error by 
merely looking at the Step concerned. 

21 Indicates a reference to an undefined local 


or global variable. 


PROGRAM TERMINATION 


Meaning 
Indicates an interruption of the program 
execution, caused by typing CTRL C or 


pressing the BREAK key. 


AID MESSAGE 
Meaning 


Indicates that program control has reached a 
BREAK command at Step n. BREAK commands are 
used to interrupt execution of the program 
for debugging purposes. The GO command may 
be typed to resume operation. 
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C.4 MUMPS OPERATING SYSTEM ERROR MESSAGES 


Message SE Index Meaning 

GARBO None Disk error while reading a data block. 

GARB1 None Disk error while writing a data block. 

GARB2 None Disk error while reading a bit map. 

GARB3 None Disk error while writing a bit map. 

GARB4 None Disk error, an attempt to deallocate a bit 


Map or data block not yet allocated. 


NOTE 


The above errors are disk errors 
detected by the system's Garbage 
Collector routine. The message is 
output to the console terminal. 
GARB1 and GARB3 result in suspension 
of all disk I/O until system restart. 
Notify system manager. 


DBDGD -0.31 Indicates a data base degradation. The 
system attempted to read a block that was not 
actually allocated. Notify system manager. 


DKDER -0.33 Indicates that a disk I/O occurred on an 
attempt to write a global data buffer. The 
error is not given until the write is 
actually attempted. 


DKFUL -0.26 Indicates that there is no more room on _ the 
disk for global or program storage. Caused 
by SET and FILE commands. Notify system 


Manager. 

DKHER -0.20 Indicates disk hardware error. Notify system 
manager. 

DKSER -0.04 Indicates that disk block pointers in the 


global data base are referencing nonexistent 
or invalid disk blocks (see also conditions 
listed under C.1). Notify system manager. 


DSKDG -0.18 Indicates disk degradation. Attempt was made 
to allocate bit map for data storage. The 
system corrects the bit map subsequent to 
this error. Notify system manager. 


DTERR -0.30 Indicates DECtape hardware or operator error. 
Common causes are: 


1. not set to ON LINE 
25 not set to WRITE ENABLE 


3. unit number not selected. 


Message 


LPERR 


MTERR 


PLDER 


SWAP 


SYSDG 


SYSER 


SE Index 


-0.38 


-0.37 


-0.35 


-0.32 


-0.25 


-0.22 
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Meaning 


Indicates a line printer hardware error. 
Common causes are: 


1. device off line 
2. out of paper 

3. yoke open 

4. power off. 


Indicates magtape hardware or operator error 
as determined by the current contents of the 
$A System Variable. The system generates 
this error only if the user SET the $E System 
Variable. 


Indicates that the system cannot retrieve the 
program being LOADed, .CALLed, or STARTed. 
The FILE command did not complete writing the 
program. The user must re-FILE the backup 
copy of the program. 


Indicates: 


1. that the previous swap-out overflowed the 
user partition stack. The error is not 
reported until the next swap-in. 


2. imminent system stack overflow. May be 
caused by faulty programming techniques, 
for example: 


1.10 F I=1:1:1000D 2 
2.10 Dl 


Indicates that the table in main memory which 
represents the bit maps on a physical disk 
unit (Disk Storage Allocation Table) does not 
correspond to the block allocation specified 
by the disk's bit maps. The Disk Block Tally 
Utility Program allows recovery from this 
error. Notify system manager. 


Indicates system stack underflow on swapout. 
Notify system manager. 
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SYMBOL USAGE 


The following special symbols are used by MUMPS in addition to the 
logical operators described in Chapter 2. 


Symbol 


~v 


Definition 


Number sign is used as a format control character to 
initiate a Page Feed or a FORM FEED on an output 
device. 


Exclamation point is used as a format control character 
to initiate a Carriage RETURN/LINE FEED sequence on an 
output device. 


Question mark is multiply defined: 


1. as an output format control character for 
terminals, line printer and paper-tape punch. It 
is followed by an nve to indicate the number of 
spaces to tabulate in from the absolute left margin 
(e.g., ?5=5 spaces from the left margin). 


2. aS an expression operator, it is followed by a 
Pattern Specification Code (psc). 


3. as the first character printed when a BREAK command 
or error interrupts a program's execution. 


Comma is used as the term separator in an argument 
list. 


Space is multiply defined: 


1. A command followed immediately by two spaces 
indicates the command has no arguments; 


2. One space separates a command from its arguments, 
or the last argument of a preceding command from 
the next command on the line. 

Colon is multiply defined: 


1. used as a delimiter for field separation in the 
argument of FOR, MODIFY, and ASSIGN commands. 


2. used to indicate the presence of an optional 


expression appended to a command or the argument of 
a command (where allowed). 


D-1 


Symbol 


=e 


4+ or * 


SYMBOL USAGE 
Definition 


3. used to indicate the presence of an optional bve 
appended to a command (:bve may not be appended to 
FOR, ELSE or IF commands). If the bve is true, the 
command is executed. If the bve is false, control 
is passed to the next command on the line or _ the 
next line (whichever is applicable). The "next 
command on the line" is identified by skipping to 
the ‘second space following the bve. If a bve is 
appended to a command, no argument of that command 
may contain a space (i.e., a string literal 
enclosed in quotes). 


Semicolon is used as a delimiter to indicate the 
remainder of a line is a comment. 


Right caret is the prompting character used by MUMPS-11 
when operating in Direct Mode to signal to the user 
that the system is ready to accept a command; that is, 
commands and functions may be entered for immediate 
execution, or program steps may be entered for program 
execution. 


Dollar sign is multiply utilized: 
1. precedes the first character of a system variable. 
2. precedes the first character of a function name. 


Percent sign is used as the first character of a 
library program or library global name. 


Quotation marks are used to delimit literals. 

Back arrow or underscore is used to specify the 
indirection operation used for command argument 
replacement. 


Up-arrow or up-caret precedes a global variable 
reference. 
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x 2" x 2 x 2 
0.001 1.00069 33874 62581 0.01 1.00695 55500 56719 0.1 1.07177 34625 36293 
0.002 1.00138 72557 11335 0.02 1.01395 94797 90029 0.2 1.14869 83549 97035 
0.003 1.00208 16050 79633 0.03 1.02101 21257 07193 0.3 1.23114 44133 44916 
C.004 1.00277 64359 01078 0.04 1.02811 38266 56067 0.4 1.31950 79107 72894 
0.005 1.00347 17485 09503 0.05 1.03526 49238 41377 0.5 1.41421 35623 73095 
0.006 1.00416 75432 38973 0.06 1.04246 57608 41121 0.6 1.51571 65665 10398 
0.007 1.00486 38204 23785 0.07 1.04971 66836 23067 0.7 1.62450 47927 12471 
0.008 1.00556 05803 98468 0.08 1.05701 80405 61380 0.8 1.74110 11265 92248 
0.009 1.00625 78234 97782 0.09 1.06437 01824 53360 0.9 1.86606 59830 73615 
=n 
10°" IN OCTAL 
10° n 10° 10° n 10° 
0 1.000 000 000 000 000 000 00 112 402 762 000 10 0.000 000 000 006 676 
12 1 0.063 146 314 631 463 146 31 1 351 035 564 000 11 0.000 000 000 000 537 
144 2 0.005 075 341 217 270 243 66 16 432 451 210 000 12 0.000 000 000 000 043 
1 750 3 0.000 406 111 564 570 651 77 221 411 634 520 000 13 0.000 000 000 000 003 
23 420 4 0.000 032 155 613 530 704 15 2 657 142 036 440 000 14 0.000 000 000 000 000 
303 240 5 0.000 002 476 132 610 706 64 34 327 724 461 500 000 15 0.000 000 000 000 000 
641 100 6 0.000 000 206 157 364 055 37 434 157 115 760 200 000 16 0.000 000 000 000 000 
113 200 7 0.000 000 015 327 745 152 75 5 432 127 413 542 400 000 17 0.000 000 000 000 000 
360 400 8 0.000 000 001 257 143 561 06 67 405 553 164 731 000 000 18 0.000 000 000 000 000 
545 000 9 0.000 000 000 104 560 276 41 
n log,, 2, n log, 10 IN DECIMAL 
n n logio 2 n log, 10 n n logio 2 n log, 10 
1 0.30102 99957 3.32192 80949 6 1.80617 99740 19.93156 85693 
2 0.60205 99913 6.64385 61898 7 2.10720 99696 23.25349 66642 
3 0.90308 99870 9.96578 42847 8 2.40823 99653 26.57542 47591 
4 1.20411 99827 13.28771 23795 9 2.70926 99610 29.89735 28540 
5 1.50514 99783 16.60964 04744 10 3.01029 99566 33.21928 09489 
Addition Multiplication 
Binary Scale 
0o+0O= 0 ox~o=0 
O+1=14+0= 1 Oxl=s1x0=0 
1+1=10 1x1=1 
Octal Scale 
0} 01 02 03 04 05 06 O07 
x = 3.11037 552421, e = 2.55760 521305s + = | 0.44742 147707, 
ml! = 0.24276 301556, e-' = 0.27426 530661. Iny = — 0.43127 233602, 
Vz = 1.61337 611067, Ve = 1.51411 230704, logz = — ,0.62573 030645, 
In = 1.11206 404435, logioe = 0.33626 754251e¢ V2= 1.32404 746320, 
logzz = 1.51544 163223, logze = 1.34252 166245. In2= 0.54271 027760. 
V10 = 3.12305 407267, log: 10 = 3.24464 7411368 In 10 = 2.23273 067355. 
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E 


TABLES 


2* IN DECIMAL 


E-1 


337 
657 
136 
411 
264 


022 
001 
000 
000 


OMNAUNAWNYO 3 


CONVERSION TABLES 


POWERS OF TWO 


000 
000 
000 
000 
000 
000 
000 
000 


5 

25 

625 

812 5 

406 25 

203 125 

601 562 5 
800 781 25 
900 390 625 
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OCTAL-DECIMAL CONVERSION 
OCTAL-DECIMAL INTEGER CONVERSION TABLE 


0000 0000 
to to 
0777 0511 


(Octal) | (Decimal) 


Octal Decimal 
10000- 4096 
20000- 8192 
30000 - 12288 
40000 - 16384 
50000 - 20480 
60000 - 24576 
70000 - 28672 


1000 | 0512 
to to 
1777 1023 
(Octal) | (Decimal) 


CONVERSION TABLES 


OCTAL-DECIMAL INTEGER CONVERSION TABLE continued) 


2000 1024 
to to 
2777 1535 


(Octal) | (Decimal) 


Octal Decimal 
10000- 4096 
20000- 8192 
30000 - 12288 
40000 - 16384 
50000 - 20480 
60000 - 24576 
70000 - 28672 


3000 1536 
to to 

3777 2047 

(Octal) | (Decimal) 
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OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


2049 2050 2051 2304 2305 2306 

asa a 2057 2058 2059 2312 2313 2314 

4777 2559 2065 2066 2067 2320 2321 2322 

(Octal) |(Decimal) 2073 2074 2075 2328 2329 2330 

2081 2082 2083 2336 2337 2338 

; : 2089 2090 2091 50] 2344 2345 2346 

Octal Decimal 2097 2098 2099 2352 2353 2354 

aeauae ae 2105 2106 2107 2360 2361 2362 

soe eco 213 2114 2115 2368 2369 2370 

eounn <16oe4 2121 2122 2123 2376 2377 2378 

50000 - 20480 

ngs oaere 2129 2130 2131 2384 2385 2386 

SAn0O BHeee 2137 2138 2139 2392 2393 2394 

2145 2146 2147 2400 2401 2402 

2153 2154 2155 2408 2409 2410 

2161 2162 2163 2416 2417 2418 

2169 2170 2171 2424 2425 2426 

2177 2178 2179 2432 2433 2434 

2185 2186 2187 2440 2441 2442 

2193 2194 2195 2448 2449 2450 

2201 2202 2203 2456 2457 2458 

2209 2210 2211 2464 2465 2466 

2217 2218 2219 2472 2473 2474 

2225 2226 2227 2480 2481 2482 

2233 2234 2235 2488 2489 2490 

2241 2242 2243 2496 2497 2498 

2249 2250 2251 2504 2505 2506 

2257 2258 2259 2512 2513 2514 

2265 2266 2267 2520 2521 2522 

2273 2274 2275 2528 2529 2530 

2281 2282 2283 2536 2537 2538 

2289 2290 2291 2544 2545 2546 

2297 2298 2299 2552 2553 2554 
5000 | 2560 2564 
ne rae 2572 
5777 | 3071 2580 


2588 
2596 
2604 
2612 
2620 


(Octal) | (Decimal) 


2628 
2636 
2644 
2652 
2660 
2668 
2676 
2684 


2692 
2700 
2708 
2716 
2724 
2732 
2740 
2748 


2756 
2764 
2772 
2780 
2788 
2796 
2804 
2812 
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OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


6000 3072 


to to 
6777 3583 
(Octal) | (Decimal) 


Octal Decimal 
10000- 4096 
20000- 8192 


7000 3584 
to to 
7777 4095 
(Octal) | (Decimal) 


CONVERSION TABLES 


OCTAL-DECIMAL FRACTION CONVERSION TABLE 


Octal Decimal Octal Decimal Octal Decimal Octal Decimal 


. 000000 . 125000 é . 250000 ; . 375000 
001953 . 126953 : 251953 : . 376953 
. 003906 . . 128906 ; . 253906 378906 
005859 ; . 130859 : . 255859 . 380859 
007812 : 132812 : 257812 382812 
009765 : 134765 : . 259765 "384765 
011718 ; . 136718 : . 261718 . 386718 
013671 : . 138671 . . 263671 388671 
015625 : . 140625 ; . 265625 390625, 
017578 . . 142578 ; . 267578 392578 - 
019531 y . 144531 : 269531 ; 394531 
021484 : . 146484 : 271484 396484 
023437 . 148437 . . 273437 . 398437 
. 025390 : . 150390 . . 275390 . 400390 
027343 . . 152343 ; 277343 402343 
029296 ; . 154296 ’ 279296 404296 
031250 2 . 156250 ; . 281250 . 406250 
. 033203 . . 158203 : . 283203 : . 408203 
035156 : . 160156 ; . 285156 : 410156 
037109 . . 162109 : . 287109 .412109 
039062 ‘ . 164062 : . 289062 . 414062 
041015 . 166015 : 291015, 416015 
042968 : . 167968 : . 292968 . 417968 
044921 169921 : 294921 419921 
046875 171875 : . 296875 421875 
048828 : 173828 . . 298828 423828 
050781 : 175781 ‘ 300781 . 426781 
052734 . 137734 . 302734 : 427734 
. 054687 : 179687 : , 304687 : 429687 
056640 : . 181640 : . 306640 335 . 431640 
. 058593 : . 183593 ; 308593 . 433593 
. 060546 : . 185546 : 310546 . 435546 
062500 ; 187500 ; 312500 . 437500 
064453 : . 189453 : 314453 439453 
. 066406 : 191406 ; 316406 441406 
. 068359 ; 193359 3 318359 : 443359 
070312 : 195312 : 320312 445312 
072265 . 197265 : 322265 447265 
074218 } 199218 : 324218 449218 
076171 : 201171 ; 326171 451171 
078125 : . 203125 : 328125 453125 
. 080078 : . 205078 ; . 330078 ? . 455078 
082031 : 207031 . 332031 457031 
083984 : 208984 3 333984 458984 
. 085937 : 210937 335937 460937 
. 087890 : . 212890 ; 337890 462890 
089843 ‘ . , 214843 339843 . 464843 
091796 ; . 216796 ; 341796 466796 
. 093750 ; 218750 343750 . 468750 
095703 : 220703 345703 470703 
097656 . 222656 347656 472656 
099609 ; 224609 ; 349609 474609 
101562 F . 226562 ; 351562 476562 
103515 d 228515 353515 ; 478515 
. 105468 230468 , 355468 460468 
107421 232421 357421 482421 
109375 ‘ . 234375 359375 484375 
. 111328 ; 236328 361328 ; 486328 
113281 : . 238281 363281 488281 
115234 , . 240234 365234 490234 
117187 ; . 242187 . 367187 492187 
119140 : . 244140 : 369140 494140 
. 121093 ; 246093 . 371093 496093 
. 123046 : 248046 373046 498046 
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OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal Decimal Octal Decimal 
.~ 000000 .- 000000 .- 000100 000244 
000001 - 000003 000101 000247 
000002 000007 000102 000251 
. 000003 000011 000103 000255 
000004 000015 000104 000259 
000005 000019 000105 000263 
000006 . 000022 000106 009267 
. 000007 . 000026 000107 000270 
000010 . 000030 , 000110 . 000274 
000011 . 000034 000111 000278 
000012 000038 000112 . 000282 
000013 000041 000113 . 000286 
000014 000045 000114 000289 
000015 000049 000115 000293 
000016 000053 000116 000297 
000017 . 000057 000117 000301 
. 000020 000061 000120 . 000305 
000021 000064 000121 000308 
000022 . 000068 000122 000312 
. 000023 000072 000123 000316 
000024 000076 000124 000320 
. 000025 . 000080 000125 000324 
. 000026 . 000083 000126 - 000328 
000027 . 000087 000127 000331 
000030 000091 000130 000335 
. 000031 000095 000131 000339 
. 000032 . 000099 000132 . 000343 
000033 000102 000133 000347 
.- 000034 000106 000134 000350 
000035 000110 000135 . 000354 
000036 000114 000136 000358 
000037 000118 000137 . 000362 
. 000040 000122 006140 . 000366 
.000041 000125 000141 000370 
000042 000129 000142 . 000373 
. 000043 . 000133 000143 000377 
. 000044 000137 000144 000381 
000045 000141 000145 . 000385 
. 000046 000144 000146 . 000389 
000047 000148 000147 . 000392 
. 000050 000152 . 000150 000396 
.000051 000156 000151 . 000400 
. 000052 000160 000152 . 000404 
000053 000164 000153 000408 
000054 000167 .000154 000411 
000055 .000171 000155 000415 
. 000056 000175 000156 . 000419 
000057 000179 000157 000423 
. 000060 000183 000160 . 000427 
000061 . 000186 000161 000431 
000062 . 000190 000162 000434 
. 000063 . 000194 000163 . 000438 
000064 000198 000164 . 000442 
000065 000202 000165 . 000446 
000066 000205 000166 000450 
000067 000209 000167 000453 
000070 000213 .000170 000457 
000071 000217 .000171 000461 
000072 000221 000172 000465 
000073 000225 000173 000469 
. 000074 . 000228 000174 000473 
000075 . 000232 000175 000476 
000076 000236 000176 . 000480 
~000077 000240 000177 000484 


Octal Decimal 


E-8 


- 000200 
.000201 
. 000202 
- 000203 
. 000204 
. 000205 
- 000206 
. 000207 
- 000210 
000211 
. 000212 
- 000213 
. 000214 
000215 
000216 
- 000217 
. 000220 
. 000221 
. 000222 
. 000223 
. 000224 
. 000225 
. 000226 
. 000227 
. 000230 
000231 
. 000232 
. 000233 
. 000234 
. 000235 
. 000236 
. 000237 
. 000240 
. 000241 
. 000242 
. 000243 
000244 
. 000245 
. 000246 
- 000247 
- 000250 
.000251 
. 009252 
. 000253 
- 000254 
- 000255 
- 000256 
. 000257 
- 000260 


.000261 


000262 
000263 
000264 
000265 
. 000266 
000267 
000270 
000271 
000272 
000273 
000274 
000275 
. 000276 
000277 


. 000488 
000492 
000495 
. 000499 
. 000503 
. 000507 
000511 
000514 
000518 
. 000522 
000526 
. 000530 
. 000534 
000537 
000541 
000545 
. 000549 
000553 
. 000556 
. 000560 
. 000564 
. 000568 
. 000572 
000576 
. 000579 
000583 
. 000587 
000591 
. 000595 
000598 
000602 
000606 
000610 
000614 
000617 
000621 
000625 
000629 
. 000633 
. 000637 
000640 
000644 
. 000648 
. 000652 
. 000656 
000659 
. 000663 
. 000667 
, 000671 
000675 
000679 
. 000682 
. 000686 
. 000690 
000694 
000698 
000701 
000705 
.000709 
000713 
000717 
. 000720 
000724 
. 000728 


Octal Decimal 
a 
-000300 ©, 000732 
.000301 000736 
.000302 000740 
.000303 =. 000743 
.000304 000747 
.090305 =, 000751 
.000306 =. 000755 
.000307 000759 
.000310 .000762 
.000311 000766 
.000512 ,000770 
.000313 =. 000774 
.000314 000778 
.000315 000782 
.000316 000785 
.000317 =. 000789 
.000320 000793 
.000321 .000797 
.000322 =, 000801 
.000323 000805 
.000324 000808 
.000325 =, 000812 
.000326 =. 000816 
.000327  .000820 
.000330  .000823 
.000331 000827 
.000332 =. 000831 
.000333 =. 000835 
.000334 000839 
.000335 000843 
.000336 000846 
.000337 000850 
.000340 .000854 
.000341  .000858 
,000342 =, 000862 
.000343 000865 
.000344 000869 
,000345 =. 000873 
,00034, 000877 
.000347 = 000881 
.000350 000885 
.000351 000888 
.000352 000892 
.000353 000896 
.000354 000900 
.000355 000904 
.000356 000907 
.000587 =, 000911 
.000360 000915 
.000361 000919 
.000362 000923 
.000363 000926 
.000364 000930 
.000365  .000934 
.000366  .000938 
.000367 000942 
.000370 000946 
.000371 000949 
.000372 000953 
.000373  .000957 
.000374 000961 
.000375 000965 
.000376 000968 
.000377  , 000972 
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OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal Decimal Octal Decimal Octal Decimal Octal Decimal 


. 000400 . 000976 - 000500 . 001220 - 000600 - 001464 - 000700 - 001708 
. 000401 - 000980 - 000501 - 001224 - 000601 - 001468 - 000701 . 001712 
- 000402 . 000984 . 000502 . 001228 - 000602 - 001472 . 000702 . 001716 
. 000403 . 000988 . 000503 - 001232 . 000603 - 001476 . 000703 - 001720 
. 000404 . 000991 . 000504 - 001235 . 000604 - 001480 - 000704 001724 
. 000405 . 000995 . 000505 - 001239 - 000605 - 001483 - 000705 - 001728 
- 000406 . 000999 . 000506 - 001243 - 000606 - 001487 - 000706 -001731 
. 000407 . 001003 - 000507 - 001247 . 000607 001491 - 000707 001735 
. 000410 . 001007 . 000510 . 001251 - 000610 . 001495 . 000710 - 001739 
0004121 .00101C . 000511 - 001255 . 000611 - 001499 -000711 - 001743 
000412 . 001014 - 000512 . 001258 - 000612 - 001502 - 000712 001747 
- 000413 . 001018 . 000513 - 001262 - 000613 - 001506 . 000713 . 001750 
000414 - 001022 000514 - 001266 . 000614 . 001510 000714 001754 
000415 . 001026 . 000515 - 001270 - 000615 001514 000715 001758 
- 000416 - 001029 . 000516 001274 - 000616 - 001518 - 000716 - 001762 
000417 . 001033 - 000517 - 001277 . 000617 - 001522 000717 . 001766 


- 000420 . 001037 . 000520 . 001281 - 000620 - 001525 . 000720 . 001770 
- 000421 . 001041 . 000521 - 001285 - 000621 . 001529 - 000721 . 001773 
- 000422 . 001045 . 000522 . 001289 - 000622 . 001533 - 000722 001777 
. 000423 . 001049 . 000523 - 001293 . 000623 . 001537 . 000723 0017381 
. 000424 . 001052 - 000524 . 001296 . 000624 001541 . 000724 «001785 
- 000425 - 001056 - 000525 - 001300 . 000625 001544 . 000725 . 001789 
- 000426 - 001060 . 000526 - 001304 . 000626 - 001548 . 000726 . 001792 
- 000427 . 001064 . 000527 . 001308 . 000627 -001552 . 000727 . 001796 
. 000430 . 001068 . 000530 . 001312 . 000630 . 001556 . 000730 .001800 
. 000431 . 001071 . 000531 . 001316 . 000631 . 001560 . 000731 . 001804 
- 000432 . 001075 . 000532 - 001319 . 000632 . 001564 . 000732 . 001808 
- 000433 . 001079 . 000533 - 001323 . 000633 001567 . 000733 001811 
. 000434 . 001083 . 000534 - 001327 . 000634 .001571 . 000734 001815 
. 000435 . 001087 . 000535 . 001331 . 000635 . 001575 . 000735 . 001819 
- 000436 - 001091 . 000536 - 001335 . 000636 . 001579 000736 . .001823 
- 000437 . 001094 . 000537 . 001338 . 000637 - 001583 - 000737 . 001827 
. 000440 . 001098 . 000540 001342 . 000640 . 001586 . 000740 . 001831 
. 000441 . 001102 . 000541 . 001346 . 000641 . 001590 . 000741 . 001834 
. 000442 . 001106 - 000542 - 001350 . 000642 . 001594 . 000742 . 001838 
. 000443 001110 . 000543 . 001354 . 000643 . 001598 . 000743 . 001842 
000444 - 001113 - 000544 - 001358 . 000644 - 001602 . 000744 . 001846 
. 000445 001117 . 000545 - 001361 . 000645 - 001605 000745 - 001850 
. 000446 - 001121 . 000546 - 001365 . 000646 . 001609 - 000746 - 001853 
. 000447 .001125 . 000547 - 001369 . 000647 - 001613 . 000747 . 001857 
. 000450 . 001129 . 000550 . 001373 . 000650 . 001617 . 000750 001861 
. 000451 - 001132 . 000551 . 001377 . 000651 . 001621 - 000751 - 001865 
. 000452 - 001136 - 000552 - 001380 . 000652 . 001625 . 000752 . 001869 
. 000453 . 001140 . 000553 . 001384 - 000653 . 001628 . 000753 . 001873 
- 000454 001144 . 000554 . 001388 . 000654 . 001632 000754 . 001876 
. 000455 . 001148 - 000555 - 001392 . 000655 . 001636 - 000755 . 001880 
. 000456 - 001152 . 000556 - 001396 . 000656 . 001640 - 000756 001884 
. 000457 .001155 - 000557 - 001399 . 000657 . 001644 .000757 - 001888 
- 000460 . 001159 . 000560 . 001403 - 000660 . 001647 000760 . 001892 
- 000461 - 001163 . 000561 - 001407 . 000661 . 001651 - 000761 . 001895 
- 000462 901167 . 000562 001411 . 000662 . 001655 . 000762 .001899 
. 000463 001171 . 000563 . 001415 . 000663 . 001659 - 000763 - 001903 
. 000464 . 001174 . 000564 .001419 000664 . 001663 . 000764 . 001907 
. 000465 . 001178 . 000565 - 001422 . 000665 - 001667 . 000765 .001911 
. 000466 . 001182 . 000566 - 001426 . 000666 . 001670 . 000766 001914 
. 000467 - 001186 . 000567 - 001430 -000667 . 001674 . 000767 001918 
. 000470 - 001190 . 000570 - 001434 . 000670 . 001678 . 000770 001922 
. 000471 .001194 .000571 . 001438 . 000671 001682 . 000771 . 001926 
- 000472 . 001197 - 000572 . 001441 - 000672 - 001686 . 000772 . 001930 
. 000473 .001201 . 000573 001445 . 000673 . 001689 . 000773 . 001934 
. 000474 . 001205 . 000574 . 001449 . 000674 . 001693 000774 . 001937 
- 000475 . 001209 - 000575 . 001453 . 000675 . 001697 . 000775 001941 
- 000476 - 001213 - 000576 . 001457 - 000676 . 001701 - 000776 .001945 
- 000477 - 001216 000577 . 001461 . 000677 - 001705 000777 - 001949 


APPENDIX F 


*SYS SYSTEM GLOBAL LAYOUT 


tSYS is a special global that contains both system configuration data 
and hardware error statistics. The global is created during system 
generation by the SYSGEN program and is under the control of the 
System UCI (UCI Number 1). The first seventeen nodes of *+SYS (Figure 
F-1) contain system configuration data obtained during system 
generation. The 0.01 through 0.07 and 10 through 17 nodes are used 
for temporary storage by SYSGEN. Nodes 18 through 64 (Figure F-2) 
contain system hardware error statistics compiled and updated by the 
System Caretaker Program (CTK). The data in these nodes are reported 
to the user by the Caretaker Reporter Program (KTR). 


4SYS SYSTEM GLOBAL LAYOUT 
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APPENDIX G 


MAGTAPE LOADING AND UNLOADING PROCEDURES 


G.1 LOADING AND THREADING TAPE 


Use the following procedure to mount and thread the tape: 


Step 


10 


Procedure 


Apply power to the transport by depressing PWR ON 
switch. 


Ensure that the LOAD/BR REL switch is in the center 
position (this applies the brakes). 


Place a write enable ring in the groove on the file 
reel if data is to be written on the tape. 


Ensure there is no ring in the groove if data on _ the 
tape is not to be erased or written over. 


Mount the file reel onto the lower hub with the groove 
facing towards the back. Ensure that the reel is 
firmly seated against the flange of the hub. 


Install the take-up reel (top) as described in Step 4. 
Move LOAD/BR REL switch to the BR REL position. 


Unwind tape from the file reel and thread the tape over 
the tape quides and head assembly. 


Wind about five turns of tape onto the take-up reel. 


Set the LOAD/BR REL switch to the LOAD position to draw 
tape into the vacuum columns. 


Select FWD and press START to advance the tape to Load 
Point, When the BOT marker is sensed, tape motion 
stops, the FWD indicator goes out, and the LOAD pT 
indicator comes on. 


NOTE 


If tape motion continues for more than 10 
seconds, press STOP, select REV (reverse) and 
press START. The tape should move to the BOT 
Marker (Load Point) before stopping. 
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G.2 UNLOADING TAPE 
To unload the tape, proceed as follows: 


1. Press OFF-LINE switch if the transport has been operating in 
the on-line mode. 


2. Press STOP switch and select REW. 


3. Press START switch. The tape should rewind until the BOT 
marker is reached. 


4. Press the LOAD/BR REL switch to release the brakes. 
5. Gently hand wind the file reel in a counterclockwise 
direction until all of the tape is wound onto the reel. 
NOTE 
When handwinding the tape, do not jerk the reel. 


This can stretch or compress the tape which could 
cause irreparable damage. 


6. Remove the file reel from the hub assembly. 


APPENDIX H 


NON-STANDARD TERMINAL DEVICE CONNECTION PROCEDURES 


H.1 INTRODUCTION 


This appendix describes the procedures for connecting non-standard 
terminal devices to the system's terminal I/O driver (IOD). 
Non-standard terminal devices are any devices that can be connected to 
Standard DEC single-line communication controllers, such as models 
DL11, KL11 = and DCcll. Two examples of DIGITAL~manufactured 
non-standard terminal devices are the RTO2 data entry terminal and a 
second LP11 or LS11 line printer. 


Before performing these procedures, each device and its associated 
controller must be connected into the system's hardware by a DEC Field 
Service representative. Further, the user must obtain the addresses 
of the interrupt vector and 1/0 registers for each device from the DEC 
representative. 


H.2 PROCEDURE 


1. Perform System Generation (Chapter 3) and specify the 
existence and characteristics of the non-standard terminal 
device(s) being used (see 3.8.2.6 and 3.8.7). 


2. After System Generation (SYSGEN) finishes its Operation, do 
not save the system as instructed in 3.8.10; instead, 
perform the following steps: 


a. Determine the base address of the device's device 
descriptor buffer (DDB) (1) from the formula: 


DDB Base Address = C(SYSTAB+6) +(32* (dn-1) 


Where: 
Cc = "contents of" 
SYSTAB = Base Address of MUMPS-11 System Table! 
dn = Device Number 


b. Using Mini-ODT (Chapter 4) 
1. Enter the base address of the DDB in the first word 
of the device's interrupt vector (VECTOR+0). 


1. Refer to Appendix F in the MUMPS-11 Programmer's Guide for further 
information. 
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2. Enter the constant 300(8) (PSW value) in the second 
word of the vector (VECTOR+2). 


3. Enter the address of the device's receiver status 
register in DDB+4 of the device descriptor buffer. 
If the device has no receiver, enter a dummy relative 
address. This is calculated by subtracting 4 from 
the address of the device's transmitter status 
register. 


4. Enter the initial values for the device's status 
registers in DDB+6 (receiver register) and DDB+10 
(transmitter register). For example, the initial 
value for the receiver status register of a DLIIA 
controller that is connected to a terminal's keyboard 
would be 100(8). If a transmit-only device is used, 
the controller's receiver status register must 
contain a 0. 


3. When all the steps above are completed, the device is 
connected to the system and the new system should be saved as 
described in Section 3.8.10. 
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MUMPS BACKUP AND UTILITY SYSTEM 


I.1 INTRODUCTION 


The MUMPS Backup and Utility System (MBU) is a bootable, stand-alone 
system. MBU allows you to back up or save the significant data from 
MUMPS disks so that in the event of a system failure, the disks can be 
restored to their former. states. MBU also allows you to save 
individual globals for later restoring via the MUMPS %LR Logical 
Restore program. In addition, MBU performs the following important 
utility functions: 


1. labels disks, DECtapes and magtapes, for indentification 
purposes and for prevention of inadvertent destruction of 
important data; 


2. formats and tests disks; also initializes disks to be used 
in a MUMPS environment; 


3. makes exact image copies of magtape, DECtape and disk volumes 
to allow you to back up non-MUMPS data; 


4. allows you to directly allocate or deallocate individual 
blocks on a MUMPS disk; 


5. performs automatic handling of "bad" (known to be unusable) 
blocks. "Bad" blocks are any blocks which cause errors 
during formatting or testing, in addition to blocks which you 
declare explicitly to be bad. 


Instructions for creating a bootable image of MBU on DECtape or 
Magtape are contained in Section I.7. 


I.2 HOW TO USE MBU 


Once loaded into memory, MBU begins executing automatically. 
Thereafter you need only answer the question it asks in order to have 
it perform the operations desired. If you are in doubt as to the way 
in which a particular question should be answered, you may type the 
single character "H" (followed by a Carriage RETURN), and you will 
receive a list of sample answers to the question, showing the format 
in which the answer is expected. Note that if you type "H" in 
response to the very first question MBU asks, you will receive an "MBU 
Command Summary" -- a brief description of all MBU commands, 
explaining the use of each. A sample MBU command summary is 
reproduced in Section I.8 of this Appendix. 
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I.3  BEGINNERS' GUIDE TO MBU 


This section is intended for operators who are not yet. familiar with 
MBU and who wish to perform simple operations, such as labeling disks, 
backing up disks to magtape, making image copies of disks, DECtapes or 
Magtapes, or formatting disks. The section consists entirely of an 
output listing from an MBU session during which the operator actually 
performed these functions. Comments have been added to explain the 
operator's intentions. (Note: All comments are in small letters and 
are enclosed in parentheses. The computer output itself, as printed 
at the operator's console, is in CAPITAL LETTERS: everything typed by 
the operator is in UNDERLINED CAPITAL LETTERS; the rest was typed 
automatically by MBU.) 


For more detailed explanations of the commands shown here, and for 
descriptions of the remaining MBU commands, see Section 1.4. 


(start of sesson: operator boots MBU, from disk, DECtape or 
Magtape; it prints introductory message and asks for first 
command . . . operator will put a label on the disk mounted 
on RKOS5 (RK) unit zero) 


MUMPS BACKUP UTILITY .. . V01.2 
TYPE H FOR HELP AT ANY TIME 


YOU MAY TYPE H NOW, FOR A SUMMARY 
OF ALL MBU COMMANDS AVAILABLE. 
(36. BUFFERS AVAILABLE) 


COMMAND? LABEL 

DEVICE & UNIT? RKO 

(NO MBU LABEL CURRENTLY ON VOLUME) 

DO YOU WISH TO PUT A NEW LABEL ON VOLUME (Y OR N) ? ¥ 
MASTER LABEL (MA) OR BACKUP LABEL (BA) ? MA 

NEW LABEL: "RK DISK 1, 2/1/77" 

OPERATION COMPLETE. 


(operator now wishes to check the labels on RPO4 (RJ) units 
zero and one) 


COMMAND? LABEL 

DEVICE & UNIT? RJO 

MASTER LABEL CURRENTLY ON VOLUME IS: "MUMPS SYS 2/13" 
DO YOU WISH TO PUT A NEW LABEL ON VOLUME (Y OR N) ? N 
OPERATION COMPLETE. 


COMMAND? LABEL RJl 

MASTER LABEL CURRENTLY ON VOLUME IS: "RJ DATA DISK" 
DO YOU WISH TO PUT A NEW LABEL ON VOLUME (Y OR N) ? N 
OPERATION COMPLETE. 


(Operator is now going to back up the contents of disk RKO 
to TU16 magtape unit MM2) 


COMMAND? BACKUP 

MASTER UNIT TO BE BACKED UP? RKO 

LABEL: "RK DISK 1, 2/1/7" 

ENTIRE VOLUME (EN) OR ONLY MUMPS BLOCKS-IN-USE (IU) ? EN 
BACKUP UNIT TO BE WRITTEN TO? MN2 

LABEL: "MY RK SYS BACKUP" 

(NO MBU LABEL CURRENTLY ON VOLUME) 

DO YOU WISH TO PROCEED, RELABELING THIS VOLUME (Y OR N) ? Y¥ 
VERIFY WHEN DONE (Y OR N) ? Y 

** BEGIN BACKUP 
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** BEGIN VERIFY 
** END VERIFY 
OPERATION COMPLETE. 


(operator will now check label on magtape MM2) 


COMMAND? LA MM2 

BACKUP LABEL CURRENTLY ON VOLUME IS: "MY RK SYS BACKUP" 
BACKUP VOL. 1 OF RK DISK "RK DISK 1, 2/1/77" 

DO YOU WISH TO PUT A NEW LABEL ON VOLUME (Y OR N) ? N 
OPERATION COMPLETE. 


(now the operator will format a new disk on RK unit 1, and 
make an image-copy of the RKO on this new disk) 


COMMAND? FORMAT 
DEVICE & UNIT? RK1 

FORMAT RK1 ARE YOU SURE (Y OR N) Y¥ 

** BEGIN FORMATTING 

** END FORMATTING 

DO YOU WISH TO EXECUTE TEST COMMAND (Y OR N) ? ¥ 
TEST RK1 ARE YOU SURE (Y OR N) ? Y¥ 

TEST PATTERN 1 (Y OR N) ? ¥ 

** BEGIN TEST 

** END TEST 

TEST PATTERN 2 (Y OR N) 
TEST PATTERN 3 (Y OR N) 
TEST PATTERN 4 (Y OR N) ? N 
DO YOU WISH TO INITIALIZE AS A MUMPS VOLUME (Y OR N) ? N 
BACKUP LABEL CURRENTLY ON VOLUME IS: "*MBU*" 

DO YOU WISH TO PUT A NEW LABEL ON VOLUME (Y OR N) ? N 
OPERATION COMPLETE. 


Nov 
Za IZIZ 


COMMAND? COPY 
MASTER ("FROM") UNIT? RKO 

MASTER LABEL CURRENTLY ON VOLUME IS: "RK DISK 1, 2/1/77" 
BACKUP ("TO") UNIT? RKl 

BACKUP LABEL CURRENTLY ON VOLUME IS: "*MBU*" 
COPY "SPARE" BLOCKS TOO (Y OR N) ? ¥ 

COMPARE WHEN DONE (Y OR N) ? Y¥ 

** BEGIN COPY 

(NOTE: LABEL BLOCK WILL NOT BE COPIED) 

** BEGIN COMPARE 

(NOTE: LABEL BLOCK WILL NOT BE COMPARED) 

** END COMPARE 

OPERATION COMPLETE. 


I.4 MBU COMMAND DESCRIPTIONS 
I.4.1 The LABEL Command 


The LABEL command is used to place a new MBU label on a volume or to 
examine the MBU label already on it. There are two types of MBU 
labels. A "master" label should be placed on a volume if it contains 
important data which you do not wish inadvertently destroyed. MBU 
will help you protect the volume by: (a) not allowing you to use a 
Master volume as the "BACKUP" or "TO" volume in any "BACKUP", "COPY" 
or "SAVE" operation, and (b) informing you that there is a master 
label on the volume if you are about to FORMAT or INITIALIZE the 
volume or, you may place a "backup" label on a volume if it does not 
contain important data and you are labeling it for identification 
purposes only, or if it is to be used as the "BACKUP" or "TO" volume 
in a "BACKUP", "COPY" or "SAVE" operation. 
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See Section 1.3 for examples demonstrating the use of the MBU LABEL 
command. 


Notes: 


1. When you are asked to specify an MBU label, you specify a 
string of up to 20 characters, enclosed in quotes, like this: 
"THE MBU LABEL" 


2. When an MBU label is placed on a volume, what is actually 
written is an entire block (256. computer words) of 
information, including: 


a. the label string you specified, 


b. information identifying the label as either a master or a 
backup label, ; 


c. the volume's bad-block table, if there are any _ known, 
unusable blocks on the volume, and 


d. if the volume is a backup, a complete record of the 
master volume from which it came, including the master's 
disk-type, (RK, RJ, RM, etc.) and its 20 character label 
string. 


3. When an MBU label is written on a disk, it is written near 
the end of the spare-block area of the disk. Whereas MUMPS 
(and most other operating systems) never use the spare-block 
area, you may safely place an MBU label on a MUMPS disk, even 
if it already contains data. (The actual disk addresses 
(block numbers) where labels are written for the various 
types of disks can be found in Table I-4.) 


I.4.2 The BACKUP Command 


The BACKUP command allows you to back up or save, the contents of any 
single disk volume, on any backup medium of your choice -- disk, 
DECtape or magtape. If the information being backed up will not fit 
on one backup volume, MBU will ask you to mount a second volume, and 
so on, until all the required information has been backed up. MBU 
will automatically number the backup volumes sequentially (starting 
with the number 1), and these volume numbers may later be inspected at 
any time using the LABEL command. When restoring from a multi-volume 
backup, MBU will, of course, check the backup volume numbers) and 
inform you if you have mounted a backup volume out of sequence. 


Most of the questions MBU asks in connection with the BACKUP command 
are extremely straightforward. The following two, however, require 
detailed explanations. 


(1) ENTIRE VOLUME (EN) OR ONLY MUMPS BLOCKS-IN-USE (IU) ? 


If you respond EN to this question, MBU will backup the entire master 
volume you have specified -- that is, all blocks of the specified 
master disk except the spare blocks. Note that the spare blocks are 
never used by MUMPS, so typing EN guarantees that all blocks ever 
accessible to MUMPS will be backed up. 
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If you respond IU to the above question, MBU will back up only (a) 
those blocks from the master volume that are specifically indicated as 
in-use (allocated) in the MUMPS bit maps on the volume, plus (b) any 
blocks contained in SDP areas on the volume. 


IU is particularly useful when the master disk being backed up 
contains a significant number of free, or unused blocks. In this 
case, backing up only the in-use blocks will result in a considerable 
saving of space on the backup volume(s) with a corresponding saving of 
time. 


You should, of course, not respond IU to the above question if the 
disk you are backing up is not a MUMPS disk. 


(2) VERIFY WHEN DONE (Y OR N) ? 


This question is asked by MBU just before the backup operation 
actually begins. If you respond Y (YES), then after the backup 
Operation is complete, MBU will check all information it has written 
on the backup volume(s) to make certain that it is in fact identical 
to the information from the master that was to be backed up. It is 
recommended that you always answer Y to this question when backing up 
important data. 


An example demonstrating how the BACKUP command is used is shown in 
Section 1.3. 


I.4.3 The RESTORE Command 


The RESTORE command is used to restore a disk volume that was backed 
up using the BACKUP command. The following sample MBU session 
demonstrates how the RESTORE command is used. 


COMMAND? RESTORE 

MASTER UNIT TO BE RESTORED TO? RK5 
LABEL: "RK DISK 1, 2/1/77" 

BACKUP UNIT TO BE RESTORED FROM? MT4 
LABEL: "MY RK SYS BACKUP" 

VERIFY WHEN DONE (Y OR N) ? ¥ 

** BEGIN RESTORE 

** BEGIN VERIFY 

** END VERIFY 

OPERATION COMPLETE. 


I.4.4 The COPY And COMPARE Commands 


The COPY command is used to make an exact image-copy of a disk, 
DECtape or magtape volume on another disk (of the exact same type), 
DECtape or magtape volume, respectively. The copy may then be used in 
place of the original. 


For DECtapes, all blocks will be copied. For magtapes, everything up 
to and including the first occurrence of two consecutive end-of-file 
Marks (tape marks) will be copied. In both of these cases, you will 
be asked to specify a MASTER ("FROM") UNIT and a BACKUP ("TO") UNIT. 
The "FROM" unit is the original you wish to make a copy of -- if 
possible, you should write-protect it. The "TO" unit is the one that 
will be written on. 
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When-the volumes are disks, you are asked the additional question: 
COPY "SPARE" BLOCKS TO (Y OR N) ? 


r& the disk being copied is a MUMPS disk, or if you are certain the 
spare-block area is not being used, you may answer N to this question. 
If you answer Y to this question, the following rule holds’ true: if 
either disk contains a non-blank MBU label, then the last 5 spare 
blocks, which include the label block and bad-block table, will not be 
copied. This is to prevent the "TO" volume from acquiring an 
incorrect bad-block table. 


Just before copying actually begins, you will be asked the question: 
COMPARE WHEN DONE (Y OR N) ? 


If you answer Y, then after the copying is completed, all blocks that 
have been copied will be compared to see that they were copied 
correctly. An example showing how the COPY command is used is given 
in Section 1.3. 


Notes: 


1. If either volume contains known bad blocks (or, in other 
words, has anything in its bad-block table), you will be 
asked the additional question: 


ERROR MESSAGES EVEN FOR KNOWN.BAD BLOCKS (Y OR N) ? 


If you answer Y to this question, MBU will inform you of 
errors even if they occur in reading or writing known bad 
blocks (where errors are expected). 


2. The COMPARE command may be issued independently without first 
executing a COPY command -- you may type COMPARE in response 
to MBU's "ND?" prompt. The questions you will be asked are 
similar to those asked by the COPY command. 


I.4.5 The SAVE-GLOBALS Command 


The SAVE-GLOBALS (or SAVE) command allows you to back up individual 
globals, or all globals, from one or more specific MUMPS UCI's to 
either magtape or DECtape. The globals may later be restored using 
the MUMPS $%LR Logical Restore utility. When using the SAVE command, 
you specify as the "SYSTEM MASTER DEVICE & UNIT" the unit on which 
your MUMPS system resides. For additional master units, you specify 
any other MUMPS disks in your system on which portions of the globals 
to be backed up may reside. For the "BACKUP UNIT", you specify the 
Magtape or DECtape unit that is to hold the backed up globals. 


You may either: 
1. save all globals from a given MUMPS UCI, or 


2. type in explicitly the names of the globals you wish to save 
from that UCI. 


When MBU has determined which globals you wish to save from a given 
UCI, it saves them, then it asks: 
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NEXT UCI (TYPE <CR> WHEN DONE) ? 


thereby allowing you to save globals from as many UCI's as you wish in 
one SAVE operation. If the information being saved will not fit on 
one backup volume, MBU will request a second volume, and so on, until 
all the required globals have been saved. 


Following is a sample MBU session showing how you would save globals 
tA, *B and tC from the system manager's UCI (assume UCI code = "SYS"), 
and all globals from UCI "HAL". Assume your MUMPS system resides. on 
unit RKO, with additional units RK1 and RJO having been defined as 
part of the system during your MUMPS SYSGEN. The backup medium will 
be magtape. 


COMMAND? SAVE 

SYSTEM MASTER DEVICE & UNIT? DKO 

LABEL: "“MUMPS SYS - 1/17/77" 

NEXT MASTER DEVICE & UNIT (TYPE <CR> WHEN DONE) ? DKl 

(NO MBU LABEL CURRENTLY ON VOLUME) 

NEXT MASTER DEVICE & UNIT (TYPE <CR> WHEN DONE) ? RJO 

MASTER LABEL CURRENTLY ON VOLUME IS: "**MOUNT ON RJO **" 
NEXT MASTER DEVICE & UNIT (TYPE <CR> WHEN DONE) ? (operator typed 
Carriage RETURN) 

BACKUP UNIT? MT1 

LABEL: "3/1/77 GLOBALS" 

(LABEL BLOCK UNREADABLE) 

DO YOU WISH TO PROCEED, RE-LABELING THIS VOLUME (Y OR N) ? XY 


NEXT UCI (TYPE <CR> WHEN DONE) ? sys 
TYPE H FOR HELP 

NEXT GLOBAL? +A 

NEXT GLOBAL? tB 

NEXT GLOBAL? +C 

NEXT GLOBAL? (operator typed Carriage RETURN) 
** BEGIN SAVE 

4A SAVED 

4B SAVED 

+C SAVED 

** END SAVE 


NEXT UCI (TYPE <CR> WHEN DONE) ? HAL 
TYPE H FOR HELP 

NEXT GLOBAL? ALL 

** BEGIN SAVE 

4+H1 SAVED 

4ABC SAVED 

4MAX SAVED 

4LST SAVED 

** END SAVE 


NEXT UCI (TYPE <CR> WHEN DONE) ? (operator typed Carriage RETURN) 
OPERATION COMPLETE. 


I.4.5.1 Redirecting A Physical Unit - With most MBU commands, you are 
free to mount a volume to be used with that command on any available 
unit of the correct type. For example, if you wish to back up an RKO6 
disk, you may mount the disk cartridge on drive RMO, or RM1, or RM2, 
and so on. With the SAVE-GLOBALS command, however, all disks must be 
mounted on exactly the units they would be mounted on if you were 
running your MUMPS system. This allows MBU to correctly follow the 
disk block pointers, which tell which blocks on which disks contain 
the various parts of the globals you are saving. 
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When a disk drive that you would normally need for saving globals is 
"down" (inoperative), you can inform MBU that the disk you would 
normally mount on that drive is (today) mounted on some other drive. 
You do this with the SET ... PHYSU= ... command. Following is an 
example that demonstrates the use of this command. Assume that you 
are going to save globals, as in the example in Section 1.4.5, but 
drive RKO is "down". You might mount that disk on unit RK3 instead. 
You would then proceed as follows: 


COMMAND? SET RKO PHYSU=RK3 
RKO PHYSU=RK3 
OPERATION COMPLETE. 


COMMAND? SAVE 

SYSTEM MASTER DEVICE & UNIT? DKO 
(REDIRECTED TO DK3_ ) 

LABEL: "MUMPS SYS - 1/17/77" 


The remainder of the dialogue would be identical to that shown in 
Section 1.4.5. 


Note that any time you specify unit DKO or RKO, MBU will remind you 
that it has been redirected to unit DK3. 


Later, if you wished to redirect RKO references back to physical unit 
RKO, you could issue the command: 


SET RKO PHYSU=RKO0 


I.4.5.2 Restoring Globals Saved by MBU - Globals that were saved 
using MBU are not restored using MBU. You restore them while running 
MUMPS by calling the LR Logical Restore utility. Before restoring, 
you log in under the UCI to which you wish to restore globals. Note 
that $LR restores globals only to the UCI you are currently logged in 
under, even if the globals were originally saved from different UCI. 
LR will ask you simple questions to determine which magtape or 
DECtape unit you wish to restore globals from, and what the label on 
the tape should be. (When you are asked to type in the label, you may 
enclose it in quotes if you wish, but you are not required. If the 
label $LR finds on the tape is not the one you typed in, $%LR_ will 
stop, telling you what label it did find on the tape. Call %LR again, 
and this time mount the correct tape or specify the correct label.) 


LR conducts a simple question-and-answer session to determine which 
globals, from which UCI's on the tape, you wish to restore to the UCI 
you are currently logged in under. You need not remember exactly what 
you saved on the tape, because %LR will tell you of each new UCI and 
global as it encounters it on the tape, and will allow you to select, 
via simple yes-and-no questions, which globals you wish to restore. 
%LR will also give you the option of restoring any global under a 
different name than it had when you saved it. 


Just before restoring, %LR asks you if you wish to "kill" the present 
contents of the global before restoring. If you do not, then the 
effect is a "merge" -- all elements of the global that were saved on 
the tape are restored by @LR, but any other elements of that global 
array that were already defined in your MUMPS system before *LR was 
called, will remain defined after the restore is complete. 


%LR will terminate automatically with an appropriate message when it 


encounters the end of the data saved on your tape. You may stop its 
execution any time you wish, however, by typing CONTROL-C. 


I-8 


MUMPS BACKUP AND UTILITY SYSTEM 


I.4.6 The FORMAT And INIT Commands 


The FORMAT command allows you to "format" a brand new disk volume, and 
then, optionally, to test it for bad blocks and/or initialize it. 
Initializing consists of writing MUMPS bit maps in the appropriate 
postions on the volume, to prepare the volume for use as a MUMPS disk. 


The INIT command allows you to execute the second and third operations 
(test and initialize) without having to format the volume first. This 
command is used when the disk has already been formatted at some time 
in the past. 


An example showing the questions you will be asked when formatting, 
testing or initializing a disk volume, is given in Section 1.3. 


Notes: 


1. MBU can format the following types of disks: RP02, RPO3, 
RPO4, RPO5, RPO6 and RKOS. Note that RKO6 disks are 
delivered to customers already formatted. 


2. At the termination of any FORMAT or INIT command, MBU will 
write a backup label named "*MBU*" on the volume, if there 
was no label on it to begin with; otherwise, MBU will 
rewrite the label that was there. Note that formatting, 
testing or initializing a volume causes any other information 
previously on the volume to be lost. 


3. The INIT command can also be used to initialize a brand new 
Magtape. In this case, initializing consists of simply 
writing a backup label named "*MBU*" on the tape. It is 
recommended that any brand new magtape (one that has never 
been written on) be initialized with the INIT command before 
being used with any other MBU commands. 


I.4.7 The BOOT Command 


The BOOT command is used to exit from MBU by bootstrapping a new 
system, such as MUMPS. Normally you will boot the new system from 
unit 0 of the desired device type. Following is an example showing 
how the BOOT command is issued: 


COMMAND? BOOT 

DEVICE & UNIT? DKO 

BOOT DKO ARE YOU SURE (Y OR N) ? Y¥ 

(the system residing on disk DKO is read into memory, and control is 
transferred to it) 


I.4.8 The SET Command 


The SET command is used: 
1. to modify a device's VECTOR or CSR address, 


2. to set a magtape unit's density to other than 800 bits per 
inch, 
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3. to set a magtape unit's blocking factor to other than 8, or 


4. to declare what actual physical unit is to be associated with 
a given DEVICE & UNIT name. 


Examples of valid SET commands are given in the "MBU Command Summary" 
reproduced in Section 1.8. Further information can be found in the 
notes following the description of the SET command given there, and 
also in Sections 1.4.5.1 and 1.5.1. 


1.4.9 The BB Command 


The BB command is used to examine a disk's bad block table, or to add 
or delete entries in it. When specifying a block number to be added 
to or deleted from the table, you specify the absolute block number 
(not the MUMPS block number) of the block you wish to reference. The 
absolute block number of the first block on any disk is 0. If you 
need help computing absolute block numbers, refer to Section 1.6. 


When entering a block number, you may enter it as either a decimal or 
an octal number. You indicate a decimal number by following it with a 
period, like this: 102. 


You indicate an octal number by preceding it with a number-sign, or 
pound-sign, like this: #146. 


In the following example, the operator adds block number 146 octal to 
the bad block table on disk RJl, and deletes block number 1025 
(decimal): 


COMMAND? BB 

DEVICE & UNIT? RJl 

TYPE H FOR HELP 

TYPE EX WHEN DONE, TO EXIT 
ACTION? LIST 


RJ1 BAD-BLOCK TABLE 


#277 (191.) 
#2001 (1025.) 
#2020 (1040.) 


ACTION? INSERT #146 
ACTION? DELETE 1025. 
ACTION? LIST 


RJ1 BAD-BLOCK TABLE 
#146 (102.) 

#277 (191.) 

#2020 (1040.) 


ACTION? EXIT 
OPERATION COMPLETE. 
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I.4.10 The MM Command 


The MM command may be used to directly allocate (declare "in-use") or 
deallocate (declare "not-in-use") specific blocks on a MUMPS disk, or 
to allocate all known bad blocks on the disk. Allocating a block that 
was not previously allocated has the effect of making the block 
inaccessible to MUMPS, since MUMPS will assume that any allocated 
block is in use for some purpose. Deallocating blocks is something 
you will probably never have occasion to do. 


Since the only use you will normally have for this command is to 
allocate known bad blocks -- so that MUMPS will not attempt to use 
them -- a special action, "ALLOC BB", is provided to allow you to 
perform this operation without having to know the block numbers of the 
bad blocks. The following example shows how you would allocate all 
the bad blocks on disk RJl: 


COMMAND? MM 
DEVICE & UNIT? RJ1l 

TYPE H FOR HELP 

TYPE EX WHEN DONE, TO EXIT 
ACTION? ALLOC BB 

* FINISHED * 


ACTION? EXIT 
OPERATION COMPLETE. 


If for some reason you need to allocate or deallocate other blocks on 
the disk, type H for help where indicated, and you will receive a 
message showing you how to do this. 


Note: Any time you initialize a disk as a MUMPS disk (which results 
in writing the initial MUMPS bit maps on the disk), then, when 
initializing is complete, MBU looks at the disk's bad block table. If 
there are any known bad blocks on the volume, MBU asks you: 


ALLOCATE BAD BLOCKS ( Y OR N) ? 


You should normally answer Y to this question. 


I.5 SPECIAL DEVICES 
I.5.1 Special RP06 Considerations 


(You need only refer to this section if you have one or more RPO6 
drives in your system. Note that an RPO5 drive is, to MUMPS or MBU, 
indistinguishable from an RP04 drive.) 


A disk mounted on an RPO6 drive is treated by MUMPS V4B as if it were, 
in fact, two RPO4 disks. If, for example, your configuration 
consisted of an RP04 drive as physical drive 0, another RP04 drive as 
physical drive 1, and an RP06 drive as physical drive 2, then the 
following would hold true within your MUMPS system: 


1. when you referenced RJ unit 0, you would be referencing the 
RP04 disk mounted in physical drive 0; 


2. when you referenced RJ unit 1, you would be referencing the 
‘RPO4 disk mounted in physical drive 1; 
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3. when you referenced RJ unit 2, you would be referencing the 
first, or "“low" half of the RPO6 disk mounted on physical 
drive 2; 


4. when you referenced RJ unit 3, you would be referencing the 
second, or "high" half of the RPO6 disk mounted on physical 
drive 2. 


As a result of this division of one physical RPO6 unit into two 
logical units, MBU must provide you with two separate ways to 
reference RP06 units, for sometimes you will want to reference the 
entire RPO06 disk (for example, while formatting), and sometimes you 
will want to reference only a particular half at a time. 


To be able to reference the halves individually, you must issue two 
"SET ... PHYSU= ..." commands to MBU -- to tell it the names by which 
you will be referencing the two halves. Given the configuration 
described above, you would issue the following two SET commands to 
MBU: 


SET RJ2 PHYSU=RJ2/L 
SET RJ3 PHYSU=RJ/H 


This tells MBU that hereafter the DEVICE & UNIT name RJ2 is to _ be 
taken as a reference to the low half of physical RJ06 unit RJ2, and 
that the DEVICE & UNIT name RJ3 is to be taken as a reference to the 
high half of physical RP06 unit RJ2. It would be necessary to issue 
these commands, for example, if you were planning to save globals from 
your system, or if you wished to back up one half of your RPO06 without 
backing up the other half. 


When you wish to reference an entire RP06 unit, you specify the device 
name as RB (or DB), instead of RJ (or DJ). Here is how you might 
format a new RP06 disk on physical drive 2: 


COMMAND? FORMAT 

DEVICE & UNIT? RJ2 

MUST USE DEVICE NAME DB OR RB WHEN REFERENCING ENTIRE RPO6 
DEVICE & UNIT? DB2 

FORMAT DB2 ARE YOU SURE (Y OR N)? Y¥ 

** BEGIN FORMATTING 


etc. 


If you later wished to back up only the high half of this disk, you 
could do so as follows: 


COMMAND? SET RJ3 PHYSU=RJ2/H 
RJ3 PHYSU=RJ2/H 
OPERATION COMPLETE. 


COMMAND? BACKUP 

MASTER UNIT TO BE BACKED UP? RJ3 
(REDIRECTED TO RJ2/H) 

LABEL: 

etc. 

Notes: 


1. An RPO6 disk has only one MBU label and only one bad block 
table. 
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2. You should use the RB (or DB) form of the device name 
whenever referencing an RP06 in any of the following 
commands: LABEL, FORMAT, INIT, MM, BB, BOOT, COPY, COMPARE. 


I.5.2 Special Magtape Considerations 


Whenever you attempt to put a label on a magtape, using the LABEL 
command, or use a magtape as the "BACKUP" unit in a BACKUP or 
SAVE-GLOBALS command, MBU will first check to see if there is a 
bootable copy of MBU on the magtape. If there is, MBU will not write 
over the bootable copy of MBU, but will, instead, skip over it before 
writing the label and/or any data to be backed up. When attempting to 
read the label or restore data from the magtape, MBU (and the $%LR 
Logical Restore utility) will again skip over the bootable copy of 
MBU, before attempting to read the label or data. 


This means that you can, if you wish, back up data to, and later 
restore data from, the same magtape from which you boot MBU. This is 
especially convenient for user who have only one magtape drive. 


If you ever wish to erase the bootable copy of MBU from a magtape, you 
May do so by using the MBU "INIT" command. 


I.5.2.1 Magtape Density - MBU allows densities of 800 BPI for 
TM11/TU10 (MT) magtapes, and 800 or 1600 BPI for TJU16/TU16 (MM) 
Magtapes. Densities of 200 and 556 BPI are not supported. 


I.6 COMPUTING BLOCK NUMBERS 


MUMPS and MBU store information on disks in "disk blocks". A disk 
block holds 256 (decimal) computer words of information. There are 
three ways one can specify a particular disk block on a disk: 


l. by its cylinder, track and sector numbers, 


2. by its "absolute" block number: the block at cylinder 0, 
track 0, sector 0 is absolute block 0; the block at cylinder 
0, track 1, sector 0 is absolute block #m, if m is the number 
of blocks per track on the disk; the block at cylinder 1, 
track 0, sector 0 is absolute block #m*n, if there are n 
tracks per cylinder on the disk; or 


3. by its "MUMPS" block number: the MUMPS block number is 
always equal to the absolute block number plus some fixed 
constant which depends on the device type and MUMPS unit 
number. 


By using Tables I-l and I-2, and the formulas given in Sections 1.6.1 


and 1.6.2, you should be able to easily convert one type of block 
number to another. 
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I.6.1 Computing Absolute Block Number From Cylinder/Track/Sector 
If m is the number of disk blocks per track for a given disk type, and 
n is the number of tracks per cylinder, then the block at cylinder c, 
track t, sector s, has absolute block number A, given by: 

A= ((c * n) +t) *mt+s 
You can find the values to use for n and m, in Table I-l. 


Notes: 


1. Any time MBU asks you to specify a block number, you _ should 
specify the absolute block number. 


2. If the disk in question is an RS04, use this formula instead: 
A=t * m+ (s/2) 


(The value of s should be even.) On an RSO04, each disk block 
occupies two sectors, and there is only one cylinder. 


I.6.2 Converting To Or From Mumps Block Number 
If you know the absolute block number, A, for a given disk block on a 
given disk, then you can determine the "MUMPS" block number, M, by 
using the following formula: 

M =u * 262144. +K+A 
The constant K depends on the disk type, and is found in Table 1-2; 
and u is the unit number (0 to 7) by which you would refer to this 
disk in your MUMPS system (MUMPS logical unit number). 


If you already know the MUMPS block number, M, and you wish to compute 
the absolute block number, A, use this formula: 


A=M-K —- (u * 262144.) 
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Table I-1 
Constants For Use With Formulas in Section I.6.1 


Disk Type Blks/Tfrk Trks/Cyl Tot # Clys Tot # Cyls 
(m) (n) Accessible to MUMPS Counting Spares 


RKO5 (RK) 12. 2. 
RSO4 (RS) 32. 64. 
RPO2 (RP) 10. 20. 
RPO3 (RP) 10. 20. 
RKO6 (RM) 22. 3. 
RPO04 (RJ) 22. 19, 
RPO5 (RJ) identical to 
RP06 (RJ 22. 19, 
or RB) 


Table I-2 
Constants For Use With Formulas in Section 1.6.2 


Disk Type Constant "K" Decimal Value (Octal Value) 


RKO5 (RK) 0. ( #0) 
RSO04 (RS) 2097152. (#10000000) 
RKO6 (RM) 2097152. (#10000000) 
RPO2 (RP) 4194304. (#20000000) 
RPO3 (RP) 4194304. (#20000000) 
RPO4 (RJ) 6291456. (#30000000) 
RPO5 (RJ) identical to RP04 

RPO6 (RJ) low half: 6291456. (#30000000) 
RPO6 (RJ) high half: 6120912. (#27262732) 
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Table I-3 
Multiples of 262144. 


Decimal Value (Octal Value) 


0 * 262144. 0. #0) 
1 * 262144. 262144. (#1000000) 
2 * 262144. 524288. (#2000000) 
3 * 262144. 786432. (#3000000) 
4 * 262144. 1048576. (#4000000) 
5 * 262144. 1310720. (#5000000) 
6 * 262144. 1572864. (#6000000) 
7 * 262144. 1835008. (#7000000) 


Table I-4 
MBU Device Statistics 


Device Type Tot # Blks Tot # Blks 
Accessible to MUMPS Accessible to MBU 


RKO5 (RK) 4800. ( #11300) 4872. ( #11410) 
RS04 (RS) 2048. = ( #4000) 2048. = ( #4000) 
RKO6 (RM) 26928. ( #64460) 27104. ( #64740) 
RP02 (RP) 40000. ( #116100) 40600. ( #117230) 
RPO03 (RP) 80000. ( #234100) 81200. ( #236460) 
RP04 (RJ) 170544. ( #515060) 171798. ( #517426) 
RPO5 (RJ) identical to RP04 

RP06 (RJ) low: 170544. ( #515060) 170544. ( #515060) 
RP06 (RJ) high: 170096. ( #514160) 170126. ( #514216) 


RP06 (RB) total: N/A 340670. (#1231276) 


DECtape (DT) 578. ( #1102) 578. ( #1102) 
TM11/TU10 Magtape (MT) 
TJul6/TU16 Magtape (MM) 


Note: On DECtape and magtape, the label block is the first block 
on the volume. On any disk except RS04, the label block 
address is exactly 5 less than the total number of blocks 
accessible to MBU. (An RS04 disk cannot have a label.) 
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Table I-5 
MBU Default VECTOR and CSR Addresses 


VECTOR Address CSR Address 


#177404 
#172040 
#177440 


#176714 
#176700 
#177340 
#172522 
#172440 


I.7 HOW TO MAKE BOOTABLE COPIES OF MBU 


Your MUMPS System Builder (MSB) disk contains a bootable copy of MBU. 
If you received your MUMPS V4B system via disk distribution (RKO5 or 
RKO6), then one of the disk cartridges you received in your kit is the 
MUMPS System Builder disk. If you received your MUMPS V4B system via 
Magtape distribution, then you had to create a MUMPS System Builder 
disk according to the instructions in Chapter 2 of this manual. 


You can boot MBU directly from your MSB disk by first booting the MSB 
disk and then typing: 


>@MBU 
You can create a bootable copy of MBU on DECtape (DT), TM11/TU10 
Magtape (MT), or TJU16/TU16 magtape (MM) by first booting the MSB disk 
and then typing the command: 


>@MBUBLD 
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MBUBLD will type the following: 
* ENTER TAPE DEVICE (DT, MT, OR MM) [S]: 


Enter the two character name, DT, MT or MM, for the kind of tape you 
are using. MBUBLD will ask you to mount your tape on drive 0 of the 
appropriate device type, and will proceed to place a bootable copy of 
MBU on this drive. You can make further copies of that tape, if you 
wish, using MBU itself. 


I.8 SAMPLE MBU COMMAND SUMMARY 


MBU COMMAND SUMMARY 


IN RESPONSE TO "COMMAND? " TYPE ONE OF THE FOLLOWING: 


LA[BEL] - TO EXAMINE THE MBU LABEL CURRENTLY ON A VOLUME, OR TO PLACE 
A NEW MBU LABEL ON IT. 


BA[CKUP]- TO "BACK UP" A SINGLE DISK VOLUME. THE VOLUME TO BE BACKED 
UP NEED NOT BE MUMPS-STRUCTURED, BUT IT MUST CONTAIN A VALID 
MBU "MASTER" LABEL. THE BACKUP MEDIUM MAY BE ANY DISK, 
DECTAPE OR MAGTAPE. 


RE[STORE]- TO RESTORE THE DATA BACKED UP IN A _ PREVIOUS "BACKUP" 
OPERATION, TO THE MASTER VOLUME FROM WHICH IT CAME. 


FO[RMAT]- TO FORMAT A DISK VOLUME, AND THEN, IF DESIRED, TO EXECUTE 
"TEST" AND/OR "INIT" FUNCTIONS. CAUTION: FORMATTING DESTROYS 
ALL INFORMATION PREVIOUSLY ON VOLUME. 


IN[IT]. - TO "TEST" A VOLUME AND/OR "INITIALIZE" IT AS A MUMPS VOLUME. 
"TESTING" CONSISTS OF WRITING AND RE-READING ALL SECTORS OF 
THE VOLUME USING SEVERAL DIFFERENT BIT PATTERNS, INFORMING OPR 
OF ALL ERRORS, AND RECORDING ANY BLOCKS INVOLVED IN ERRORS IN 
THE VOLUME'S BAD-BLOCK TABLE. "INITIALIZING" CAUSES MUMPS 
BITMAPS TO BE WRITTEN IN THE APPROPRIATE SECTORS ON THE 
VOLUME, SO THAT THE VOLUME MAY LATER BE USED IN A_ MUMPS 
ENVIRONMENT. CAUTION: TESTING AND/OR INITIALIZING DESTROYS 
ALL INFORMATION PREVIOUSLY ON VOLUME. 


SA[VE-GLOBALS]- TO SAVE ALL OR SELECTED GLOBALS FROM ANY MUMPS VOLUME 
OR VOLUME-SET, ON MAGTAPE OR DECTAPE, IN A FORMAT FROM WHICH 
THE DATA CAN LATER BE RESTORED USING THE MUMPS $%LR_ (LOGICAL 
RESTORE) UTILITY. 


BB - TO LIST AND/OR MODIFY A VOLUME'S BAD BLOCK TABLE. 


MM - TO DIRECTLY ALLOCATE OR DEALLOCATE ONE OR MORE SPECIFIC 
BLOCKS ON A MUMPS-STRUCTURED VOLUME, OR TO ALLOCATE ALL BLOCKS 
CURRENTLY CONTAINED IN THE VOLUME'S BAD-BLOCK TABLE. 


BO[OT] - TO BOOT FROM ANY DESIRED DISK, DECTAPE OR MAGTAPE. (THE 
SYSTEM BEING BOOTED NEED NOT BE MUMPS.) 


COP[Y] - TO MAKE AN EXACT IMAGE COPY OF ANY VOLUME, SUCH THAT THE 
COPY MAY THEN BE USED IN PLACE OF THE ORIGINAL. NOTE: IF THE 
VOLUMES ARE DISKS AND EITHER VOLUME CONTAINS A NON-BLANK MBU 
LABEL, THE LAST 5 "SPARE" BLOCKS WILL NOT BE COPIED. THIS 
WILL PREVENT THE "TO" VOLUME'S LABEL BLOCK (AND BAD-BLOCK 
TABLE) BEING CHANGED. 
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COM[PARE]-TO COMPARE TWO VOLUMES OF THE SAME TYPE TO VERIFY THAT ONE 


SE(T] 


IS IN FACT AN EXACT IMAGE COPY OF THE OTHER. APPROPRIATE 
MESSAGES WILL IDENTIFY ANY BLOCKS WHICH ARE NOT IDENTICAL. 
(IF THE VOLUMES ARE DISK AND EITHER VOLUME CONTAINS A 
NON-BLANK MBU LABEL, THE LAST 5 "SPARE" BLOCKS WILL NOT BE 
COMPARED. ) 


- TO CHANGE ANY OF THE FOLLOWING SYSTEM INFORMATION: 

ANY DEVICE'S VECTOR OR CSR ADDRESS, 

ANY MAGTAPE UNIT'S DENSITY, 

ANY MAGTAPE UNIT'S BLOCKING FACTOR, OR 

THE ACTUAL PHYSICAL UNIT TO BE ASSOCIATED WITH A GIVEN DEVICE 
& UNIT NAME. 


EXAMPLES OF VALID "SET" COMMANDS: 


SET RPO VEC=#254 ;SET RP02/03 VECTOR ADR TO OCTAL 254 
SET DKO CSR=#177404 ;SET RK CSR ADR TO OCTAL 177404 

SET MT1l BLK=12. ;SET MT1 BLOCKING FACTOR TO 12 DECIMAL 
SET MM2 DEN=1600 ;SET MM UNIT 2'S DENSITY = 1600 BPI 
SET RK5 PHYSU=RK3 ;RE-DIRECT ANY REFERENCE TO UNIT "RK5" 


7;TO ACTUAL PHYSICAL UNIT RK3. 

SET RJ6 PHYSU=RJ4/L ;(USED WITH RP06 DRIVES ONLY) RE-DIRECT 
;ANY REFERENCE TO UNIT "RJ6" TO THE LOW 
;HALF OF PHYSICAL UNIT RJ4 (DB4). (AN 
;RPO6 IS TREATED BY MUMPS AS 2 SEPARATE 
7"RJ" UNITS. MBU ALLOWS BACKING UP OF 
;EACH HALF SEPARATELY.) 


NOTES: 


A "MAGTAPE BLOCKING FACTOR" IS THE NUMBER OF 256. WORD (512. 
BYTE) BLOCKS THAT WILL BE CONCATENATED TO FORM ONE PHYSICAL 
BLOCK ON THE TAPE. NORMALLY, THIS NUMBER SHOULD NOT EXCEED 
ONE-HALF THE NUMBER OF BUFFERS AVAILABLE. THE DEFAULT MAGTAPE 
BLOCKING FACTOR IS 8. 


IN ALL COMMANDS, OCTAL NUMBERS ARE SPECIFIED USING A PRECEDING 
NUMBER SIGN (#), DECIMAL NUMBERS WITH A FOLLOWING PERIOD (.). 
THE ONLY EXCEPTIONS ARE NUMBERS IN SET DENSITY COMMANDS, WHICH 
ARE ALWAYS ASSUMED DECIMAL, AND UNIT NUMBERS, WHICH ARE ALWAYS 
IN THE RANGE O TO 7. 
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SPECIFYING A DEVICE NAME & UNIT NUMBER: 


WHEN YOU ARE ASKED TO SPECIFY A UNIT, YOU SHOULD SPECIFY BOTH 
THE DEVICE NAME AND THE UNIT NUMBER, 
LIKE THIS: RK1 


SPECIFYING MBU LABELS: 


AN MBU LABEL CONSISTS OF UP TO 20 CHARACTERS, ENCLOSED IN 
QUOTES, LIKE THIS: "THE MBU LABEL" 

LABELS ARE PLACED ON VOLUMES BY USE OF THE MBU LABEL COMMAND, 
PLACE A BACKUP LABEL ON A VOLUME IF YOU WILL BE USING THAT 
VOLUME TO SAVE GLOBALS, OR TO BACK UP OTHER VOLUMES. PLACE A 
MASTER LABEL ON IT IF IT IS, OR IS TO BECOME, A MUMPS VOLUME, 
OR IF IT CONTAINS IMPORTANT DATA AND YOU DO NOT WISH IT TO BE 
INADVERTENTLY USED AS A BACKUP. IF YOU EVER WISH TO SPECIFY 
NO LABEL, OR A BLANK LABEL, INDICATE IT LIKE THIS: me 


CHARACTER CONVENTIONS: 


YOU MAY TYPE ESCAPE OR ALTMODE IN RESPONSE TO ANY QUESTION 
BEING ASKED, TO ABORT THE OPERATION THEN IN PROGRESS. 


YOU MAY TYPE CONTROL-C WHILE ANY NORMAL DISK OR TAPE I/O IS IN 
PROGRESS (SUCH AS DURING A’ BACKUP, RESTORE, SAVE-GLOBALS, 
COPY, COMPARE OR INIT COMMAND), TO CHECK ON THE PROGRESS OF 
THE COMMAND, AND (OPTIONALLY) TO ABORT IT. 


YOU MAY TYPE 4H IN RESPONSE TO ANY QUESTION. YOU WILL 
USUALLY RECEIVE A SAMPLE ANSWER TO THE QUESTION BEING ASKED, 
SHOWING THE FORMAT IN WHICH THE ANSWER IS EXPECTED. 
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PRESRV 


J.1 INTRODUCTION 


The Preserve program (PRESRV) is a complete stand-alone core-resident 
system; MUMPS must be shut down before starting PRESRV. Its 
principal use with MUMPS-11 is the physical formatting of discs to 
create copies of disk and tape volumes. This copy capability is the 
basis for MUMPS-1l physical backup operations. PRESRV can make copies 
in several formats, only one of which is needed for MUMPS-11 
operations. The type of copy mode which should be used for MUMPS-11 
is called image mode, which is used to copy all of the blocks from one 
medium to another. In effect, image copies are duplications. 


The following sections describe how to use PRESRV. 


Note that only the features necessary for making MUMPS-1l image copies 
are described in this manual. For a detailed description of all of 
PRESRV's capabilities, refer to Appendix A in the RSX-11M System 
Generation Manual (DEC-11-OMGIA-A-D). 


J.2 PRESRV COMMANDS 


PRESRV acts on user requests which are in either of the two following 
forms: 


1. File transfer command string 
2. Non-transfer commands 


File transfer command strings are used to specify and initiate a file 
transfer, whereas non-transfer commands are used to modify the 
interrupt vector address for a device or task for information. Before 
a transfer involving an RP04, 05 or 06 and/or a TJU16 is executed, the 
user must modify the vector address for the RP04, 05, 06 and/or the 
TJU16. 


J.2.1 File Transfer Command Strings 
PRESRV file transfer command strings have the following form: 
DFV,:filename[/switch,]...[/switch,]=DEV,:filename[/switch,]...[/switchy] 


DEV(1) is the output device designator, DEV(2) is the input device 
designator, and each /switch indicates one of the legal PRESRV switch 
options. FILENAME is used only to identify files on magtape. When a 
tape is produced by PRESRV, the user must specify a label of up to six 
characters for the tape to be produced. 
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The switches are used to specify the transfer format and to _ control 
the transfer. An image mode transfer is assumed if the device 
designators are of the same type (e.g., both are RKO5 cartridge 
discs). Otherwise, the "/M" switch must be specified. 


Following are three examples of file transfer command strings and a 
description of their actions. The PRESRV program prompts the user 
with the phrase "PRE>", and the user's responses are underlined in the 
following examples. 


PRE>MT1:ABC/BL:12.=DK1:/IM 


An image copy of the RKO5 cartridge disc on drive 1 is 
placed on the TU10 magtape drive 1 and is assigned the 
filename ABC. The file is transferred 12 blocks at a time. 


PRE>DK1:=DK0: 


An image copy of the drive 0 RKO5 cartridge disc is placed 
on drive l. 


PRE>DK1: /FO/VE=DKO: 


The drive 1 disc is physically formatted, an image copy of 
the drive 0 disc is placed on the drive 1 disc, and the 
accuracy of the transfer is verified. 


Whenever a disc file is transferred to magtape, a copy of PRESRV is 
placed at the beginning of the tape just prior to the image copy of 
the disc file. Thus, to later transfer the file from the magtape back 
to the disc, PRESRV can be booted from the tape which contains the 
image file. Section J.4 contains an example of such a transfer. 


Table J-1 contains a list of the device designators. 
Following is a list of PRESRV copy switches which are of interest to 


MUMPS-11 users. These switches are further described in the following 
sections. 


Copy Switch Effect 

/BL:nnn modify blocking factor 

/ER abort on LUN error 

/FO physically format a disc 

/IM image copy 

/PE phase-encoded option (1600 bpi) of a TJU16 
/RW rewind at completion 

/VE verify the accuracy of the transfer 
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Table J-1 
Device Designators 


Device Designator Device Medium 


DF: An RF11 disk controller with one RS1l1 disk 
unit (one platter). 


An RK11 disk controller with one to eight 
RKO3 or RKO5 drive units. DK: is 
equivalent to DKO:. 


An RP11-C disk controller with one to eight 
RPO3 disk drive units. DP: is equivalent 
to DPO:. 


An RH11 disk controller with one to eight 
RPO4 disk drive units. DB: is equivalent 
to DBO:. 


One TCll control unit with up to four TU56 
dual transports or eight DECtape drive 
units. 


MTn: filename 
(n = 0 to 7) 


One TM11 control unit with up to eight TU10 
Magtape transports. Each transport is 
designated by a unique unit number 
selectable between zero and_ seven. A 
filename (from one to six alphanumeric 
characters) must be specified for disk to 
Magtape transfers but not for magtape to 
copy operations. 


MMn: filename 
(n = 0 to 7) 


One TJU16 control unit with up to eight 
TU16 magtape transports. A filename (from 
one to six alphanumeric characters) must be 
specified for disk to magtape transfers but 
not for magtape to magtape copy operations. 


J.2.1.1 Blocking Switch (/BL:nnn) - Blocking can be imposed on either 
tape or disk-type devices. A block is a group of 256-word units which 
represents the amount of data that will be transferred by a_ single 
read or write issued by PRESRV. 


Each device has a default blocking factor which is used by PRESRV if 
no blocking switch is specified, and if buffer space is available to 
perform the default blocking. The defaults, shown in Table J-2 are 
overridden in one of two ways: 


l. If a copy is image mode, PRESRV will, for tapes, use a 
blocking factor which uses all available buffering space. 


2. The /BL switch can be used on either input or output file 
specifiers to establish a blocking factor. 
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Table J-2 
Default Block Sizes 


12 

8 
10 

2 
22 
i 
1 


The switch is of the form: 
/BL:nnn 
where: 
nnn is the number of 256(10)-word block in each record. 
The /BL switch can apply to either input or output file specifiers. 
Example: 


MT1:ABQRS/BL: 20.=DB0:/BL:11./IM 
NOTE 


1. For image copies, the blocking 
factor specified with a disk or 
*DECtape must be a submultiple of 
the number of blocks on the volume 
(e.g., 4800 for DK). 


2. If buffer space permits, use a large 


blocking factor for DECtape_ to 
improve operational efficiency. 


Blocking calculations used to match available buffering space to 
blocking specifications for a file specifier appear in Section J. 


J.2.1.2 Abort on LUN Error (/ER) - If the /ER switch is attached to a 
file specifier, an unrecoverable I/O error will cause the termination 
of the current PRESRV operation. PRESRV prompts with 

PRE> 
After issuing an error message. 
/ER applies to either input or output file specifiers. 
‘Example: 


DT1:A/ER=DK: 
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J.2.1.3 Physical Format Device Switch (/FO) - This switch directs 
that the output device be physically formatted before any transfer is 
made. The switch may be used to format RK03/05, RPO2/RP03, and RPO4 
05 and 06 disks. 


Example: 


PRE>DK1: /FO/VE=DKO0: 


J.2.1.4 Image Copy Switch (/IM) - Image mode copy produces an output 


format which is identical to the input format. If both the input and 
output devices are identical and neither has a switch, the transfer 
will automatically be made in image mode. However, if the devices are 
not identical, the Image Copy Switch should be used on the disk (or 
DECtape for *DECtape - magtape transfers) aide of the PRESRV command. 


PRE>MTO:ABC=DK1:/IM 


J.2.1.5 Phase Encoded Tape Switch (/PE) - This switch indicates that 
magtape volumes to be written or read on a TU16 drive are to be 
treated in phase-encoded mode (1600 bpi). This switch may appear on 
either input or output file specifiers. 


Example: 


MMO: /VE/PE=MM1: /PE 


J.2.1.6 Rewind at Completion (/RW) - The /RW switch will cause PRESRV 
to rewind any physical tape that has completed the specified transfer. 
The /RW applies to either input or output file specifiers. 


Example: 


MT1:FILEABC/RW=DP0:IM 


J.2.1.7 Verify Switch (/VE) - The /VE switch will cause a second pass 
over the input and output media so that every record written is read 
back and compared with the corresponding record on the input device. 
A verification failure is declared if the comparison fails. The 
verify switch applies only to output file specifiers. 


Example: 


DKO: /VE=DK1: 


J.2.2 Non-transfer Commands 


PRESRV non-transfer commands allow the user to ask for information or 
modify the interrupt vector address for a device. Three non-transfer 
commands are of interest to MUMPS users, and these three are described 
below. 
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J.2.2.1 Set Vector Address Command (/VEC) - The following is a list 
of the default interrupt vector addresses for each of the devices 
supported by PRESRV: 


Device Vectors 
DB r 320 
DF 204 
DK 220 
DP 254 
DT 214 
MM 300 
MT 224 


If the default vector address does not correspond to the actual 
hardware configuration in use, the /VEC command can be used to 
override the default value. 
This command is of the form: 

dev: /VEC=nnnnnn 


where: 


dev: = The device-unit whose vector address is to be changed. 
nnnnnn = The new octal vector address. 


Examples: 


PRE>MMO:/VEC=224 
PRE>DBO:/VEC=254 


J.2.2.2 Help Command (/HE) - The Help command, whose format is 
/HE or /HELP 


summarizes PRESRV commands, switches, and defaults. 


J.2.2.3 List Command (/LI) - Information about the file which is 
present On a magtape or DECtape can be obtained by observing the 
following sequence (for magtape). 

RSX-11S vVOl BLO1 

VOLUME PRESERVATION PROGRAM - X02 

FOR HELP TYPE /HE 

52. BLOCKS AVAILABLE FOR BUFFERING 

PRE>MTO:/LI 


LAB: ABC FRM:DKO VOL 1 BLK:10. RECSIZ:5120. 29-APR-74 00:00:01 
PRE> 


After printing the information about the file, a message 
TAPE LABEL READ ERROR 

May be printed. That warning message can be ignored. 

The date and time on the listing will be meaningless. 
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J.3 PRESRV OPERATOR GUIDE 
J.3.1 Starting Procedures 
J.3.1.1 Bootstrapping PRESRV - 


1. Mount the PRESRV tape on the appropriate drive (DECtape or 
mMagtape) 


2. Set the tape transport controls as follows: 
For DECtape 
a. Set the unit number to 0. 
b. Set the WRITE ENABLE/WRITE LOCK switch to WRITE LOCK. 
c. Set LOCAL/REMOTE switch to REMOTE. 
For magtape: 
a. Set the drive number to 0. 
b. Remove the write enable ring. 
c. Position tape at LOAD POINT. 
d. Set ON LINE/OFF LINE switch to ON LINE. 
3. Load and start the program by activating the hardware read 
only memory (ROM) bootstrap via the SWITCH REGISTER switches 
as described below. 


a. Set the console ENABLE/HALT switch to HALT. 


b. Set the console SWITCH REGISTER switches to the 
appropriate hardware bootstrap address. 


c. Press the LOAD ADRS switch. 
d. Set the ENABLE/HALT switch to ENABLE. 
e. Press the START switch. 
The tape spins and PRESRV is loaded into memory. When loading is 
complete, PRESRV is started and identifier itself at the console 
terminal: 
RSX-11S VOLUME PRESERVATION PROGRAM - Vnn 
FOR HELP TYPE /HE 
nn. BLOCKS AVAILABLE FOR BUFFERING 
Following this message PRESRV prompts with 
PRE> 


and is ready to accept commands. ‘The PRESRV tape can be removed at 
this time inasmuch as the entire PRESRV program resides in core. 
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J.3.1.2 Computing Required Blocks for Buffering - In the display, nn 
is the number of 256(10)-word blocks available for data transfer and 


verification operations. The user must use nn to determine if a given 
PRESRV media copy has sufficient buffering space. The space required 
depends on blocking factors and use of the verification switch. 
Default block sizes for devices supported by PRESRV are given in Table 
J-1. 


The example presented below illustrates the method for determining the 
blocks required for PRESRV copy operations. The rule is to establish 
the blocks required for: 

Input 

Output 

Verification 
Example 1: 

PRE>MTO:ABC = DKO:/1IM 


In this example, the following number of blocks are required for 
buffering. 


Input 12. (DK default block size) 
Output 1. (MT default block size) 
Verification 0. (No verification specified) 
Total 13. 


Example 2: 
PRE>DKO:/VE = DK1: 


Copy unit DKl to unit DKO:. Each record written to DKO: will be read 
and compared to it in-memory image. 


Input 12. (DK default block size) 

Output 12. (DK default block size) 

Verification 12. (Re-read block from DKO:) 

Total 36. 
Example 3: 

PRE>MMO: = MMI: 
Image copy MMl: to MMO:. The image copy mode will use all available 
memory buffer space in creating block on MMO. If any input record is 
too large the transfer will be aborted. 
Example 4: 

PRE>MMO:/VE = MM1: 
Image copy MMl: to MM0:. Since verification is requested, one-half 
of available memory buffer space will be used to form blocks to be 


written to MMO:. If any input record is too large, the transfer will 
be aborted. 
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J.3.1.3 Booting Another System or Stand-alone Program - The Operator 
should halt the processor and boot the other system. 


J.3.2 Operator Messages 
J.3.2.1 Action Messages - During the course of PRESRV's operation, it 
May be necessary to take certain actions. At such time, PRESRV will 
issue promoting messages to the user's terminal. These messages are 
as follows: 
**BEGIN VERIFICATION** 
MOUNT OUTPUT VOLUME AND TYPE CR> 
MOUNT INPUT VOLUME AND TYPE CR> 
OUTPUT VOLUME WRITE-LOCKED. TYPE CR WHEN READY> 
VOLUME FAULTY - "R" TO RETRY, "C" TO CONTINUE> 
The VOLUME FAULTY message is issued whenever a verification error or a 
write error occurs and the /ER switch has not been specified. 
NOTE 
If PRESRV is ready to accept input, and 


the user types "ALTMODE", the current 
operation will be aborted. 


J.3.2.2 Error Messages - ERROR IN READING COMMAND 

There is some problem with terminal input or a -Z typed illegally. 
Action: Retype command 

EXPECTED EOF NOT FOUND 


During verification of a tape image copy, an EOF mark was read from 
the input volume, but not from the output volume. 


Action: Retry the operation 
FATAL ERROR ON INPUT DEVICE 


An error has occurred while reading the input volume during a _ tape 
image copy. 


Action: Retry the operation 
‘FATAL ERROR ON OUTPUT DEVICE 


An error has occurred while reading or writing the output volume 
during a tape image copy. 


Action: Retry operation 
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ILLEGAL BLOCK COUNT 


The number of blocks specified with the /BL switch is too high for the 
available buffer space or it is 0. 


Action: Retry with valid block count 
INPUT DEVICE ERROR nnnnn nnnnn 


An error has occurred in attempting to read data. The number provided 
is the octal logical block number when the error was detected. 


Action: None 
INPUT VOLUME nn. OUT OF SEQUENCE 


The number of the input volume does not match the number of the 
required volume. 


Action: Mount proper volume and proceed 
INSUFFICIENT BUFFER SPACE 
A record (or all records) on an input tape has been found to be larger 
than the available buffer space. Alternatively, transfer 
specification requires more blocks than are available. 

Action: Abort (or retry in second case) 
LUN ASSIGNMENT ERROR 
A device and unit combination specified in a command string is either 
not represented in the current PRESRV system or is not a valid device 
for PRESRV operations. 
OUTPUT DEVICE ERROR nnnnn nnnnn 
An error has occurred reading or writing data. Retry, continue, or 
abort. The number provided is the octal logical block number when the 
error was detected. 

Action: 
SYNTAX ERROR 
Input not recognizable 

Action: Retype command 
VERIFICATION ERROR nnnnn nnnnn 
The data read back from the output volume does not match what was 
written. The number provided is the octal logical block number of the 


output device when the error was detected. 


Action: Retry, continue or abort. 
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J.4 EXAMPLES 
This section provides examples of how to provide backup of discs using 
PRESRV. The user's responses are underlined. If verification of the 


accuracy of the transfer is not desired, the /VE switch may be deleted 
in the following examples. 


J.4.1 RKO5 Disc Cartridge to Another RKO5 

PRESRV is first booted (see Section J.3.1.1 for boot instructions). 
The following sequence then occurs to transfer the contents of disk 0 
to disc l. 


PRE>DK1:/VE — DKO: 
PRE> 


J.4.2 RKO5 (RK11) to a TU1O (TM11) Magtape 
PRESRV is first booted and then the following sequence occurs. 
PRE>MTO:ABC/BL:12./VE = DKO:/IM 
MOUNT OUTPUT VOLUME 1. AND TYPE CR> 
PRE> 
Note that the volume number (1) does not imply that the magtape is on 
drive l. The volume number specifies the sequence of tapes should 
more than one tape be required to perform backup. 
The tape contents can be restored to the disc by booting PRESRV from 
the tape which contains the tape image, and by then following the 
sequence below: 
PRE>DKO:/VE = MTO:ABC/BL:12. 
MOUNT INPUT VOLUME 1. AND TYPE CR> 


PRE> 


J.4.3  RP04, 05, 06 to Another RP04, 05, 06 


PRESRV is first booted, and then the following sequence is observed to 
transfer the contents of disc 0 to disc l. 


PRE>DB: /VEC=254 
PRE>DB1: /VE=DKO 


PRE> 
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J.4.4 RH11 to a TJU16 Magtape 
’ PRESRV is booted, and the following sequence occurs. 

PRE>DB: /VEC=254 

PRE>MM: /VEC=224 

PRE>MMO:ABC/BL: 22./PE/VE=DB0/IM 

MOUNT OUTPUT VOLUME 1. AND TYPE CR> 
Several tapes are required when transferring large discs to magtapes. 
When PRESRV requests a new tape, that tape should be mounted (at load 
point) on the same unit as the former tape. 
To restore the contents of a set of tapes created on a TJU16 to an 
RJPO04, PRESRV should be booted from Volume 1, and then the following 
sequence should be observed. 

PRE>DB: /VEC=254 

PRE>MM: /VEC=224 

PRE>DBO: /VE=MM0:ABC/BL:22./PE 

MOUNT INPUT VOLUME 1. AND TYPE CR> 
Several tapes are required when transferring magtapes to large discs. 


When PRESRV requests the next tape, that tape should be mounted (at 
load point) on the same unit as the Former Tape. 
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K.1 OVERVIEW AND INTRODUCTION TO DSC 


The DSC (Disk Save and Compress) utility program copies the contents 
of Files-l1l disks to tape or disk for backup and storage, decreases 
the amount of disk space required for data storage, and transfers data 
from bad blocks to accessible ones. DSC also provides a means of 
concatenating files and extensions into contiguous data blocks, as 
well as reducing the required number of retrieval pointers and file 
extensions. 


DSC transfers and compresses data from a Files-ll formatted disk to 
either disk or tape by copying only blocks allocated to active files. 
Data files randomly scattered over the disk are accessed and written 
to a new medium without the intervening spaces. As a result, 
individual files are closer together, and the space available for new 
files is grouped together eliminating wasted space between files and 
improving access efficiency. 


The contents of a disk can be written to another disk of the same size 
or can be transcribed to magnetic tape for permanent storage. If the 
contents of one disk are transferred to a disk with a larger storage 
capacity, the new disk is formatted using the attributes of the 
original disk. The increase in available storage space is thus 
negated. 


DSC can also be used to recover from a hardware malfunction that 
renders a portion of the disk unreadable. The file, including what 
can be read from the bad block contents, is written to accessible 
blocks on a new disk where they may be restored. 


K.2 INITIATING AND TERMINATING DSC 
The DSC utility is included as part of the software package for 
RSX-11M, RSX-11D, and IAS operating systems. DSC may be initiated by 
entering either of the following commands: 

MCR> DSC 

MCR> DSC command string 


To return control to the operating system after all DSC commands have 
been completed, type CTRL Zz. 


A stand-alone version of DSC may also be used under RSX-11M by 
bootstrapping from tape. The proper tapes to be used are those 
supplied with the operating system software package or, the first 


DSC 


volume of a set of tapes which were created by DSC at a density of 800 
bytes per inch may also be used. 


K.3 DSC COMMAND FORMAT 
DSC commands are entered in the format: 

outdev: [filelabel] [/switch] = indev: [filelabel] [/switch] 
where: 


outdev: lists the physical device(s) to which data are 
transferred. The format of outdev: is AAnn: 
where AA are the ASCII charcters that specify the 
device mnemonic, and nn is the 1l- or 2-digit 
(octal) unit number, and the colon is the device 
name terminator. When more than one device is 
listed, the device symbols must appear in 
succession, separated by commas, before any other 
command parameters are specified. (See Section 
2.2.) 


[filelabel] is the identifier assigned to the disk contents 
contained in a tape file on a tape volume or 
volume set created by DSC. A _ filelabel must be 
specified when the output device is magnetic tape, 
and is optional with other devices. (See Section 
1.5.1.) 


{/switch] is one or more optional switches described in 
Sections 1.5.2 through 1.5.5.2. 


indev: lists the physical device(s) from which data are 
copied in the format AAnn: (described in outdev: 
above). 


[filelabel] is the optional tape file identifier detailed in 
[filelabel] above and in Section 1.5.1. 


[/switch] is one or more optional switches described in 
Sections 1.5.2 through 1.5.5.2. 


Consider the following example of a DSC command string: 
DSC> MMO1: .MM2:SYSFILE/DENS=1600=DB1: 


In this example, the contents of the RP04 disk pack DRl: are written 
to two TU16 tape drives MM0l1:, and MM2:. The resultant tape volume 
set recorded at a density of 1600 bytes per inch (bpi) contains all 
the data files from DBl: in the single tape file named "SYSFILE". 
Note that the tape cannot be used to bootstrap the stand-alone version 
of DSC. 
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K.4 DSC-SUPPORTED DEVICES 


The following devices may be used with DSC: 


Device Device Device 
Mnemonic Type Class 
DM RK11/RK06 cartridge disk pack Block-structured 
DB RH11/RP04,05,06 and RH70/RP04,05,06 Block-structured 
disk pack 
DK RK11/RK05 cartridge disk Block-structured 
DF RF11/RS11 fixed head disk Block-structured 
DP RP11/RP02/RP03 disk pack Block-structured 
DS RH11/RS03/RS04 and RH70/RS03/RS04 Block-structured 
fixed head disk 
MM RH11/TM02/TU16 and RH70/TM02/TU16 Tape 
9-track magnetic tape 
MT TM11/TU10 7- or 9-track magnetic tape Tape 


and TM11/TS03 9-track magnetic tape 


K.5 DATA TRANSFER 
DSC performs four distinct data transfers in its operation. Data are 
actually transferred from disk to disk, disk to tape, or tape to disk, 
but these operations consist of 

1. copying data from a disk, 

2. writing data to tape, 

3. copying data from tape, and 


4. writing the data back to disk. 


Note that DSC cannot be used to transfer data from tape to tape. 


K.6 OPTIONS 


One option and five optional switches may be used with DSC commands. 
The formats and usages of these options are discussed in the following 
sections. 


K.6.1 Filelabel 


The filelabel identifies the data copied from a disk and stored on a 
set of tape volumes. A filelabel must be specified when the output 
medium for a DSC operation is magnetic tape. 


The filelabel consists of from 1 to 12 alphanumeric characters of 
which the first nine are used by DSC to identify the tape file 
containing a disk's contents. The filelabel must follow the device 
specification and precede any switches. The filelabel is terminated 
by one of the following: 
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1. An option switch 


2. An equal sign (indicating the end of the output side of the 
command) 


3. A carriage return (indicating the end of the command string) 
Note in this example: 
DSC> MMO1: ,MM02:SYSFILE=DB1: 


that a file is created on a tape labelled SYSFILE which contains all 
the data copied from the specified disk, DBl:. The filelabel may 
optionally be used when restoring data to disk. If the filelabel is 
entered as part of the input specification, the tape is searched for a 
file with the same name as the specified filelabel. That file of disk 
contents is transferred to disk when it is located. If no filelabel 
is specified, the first file of disk contents located is transferred. 


In the following example: 
DSC>DB1:=MM01: ,MM-2:SYSFILE 


the first tape volume specified, MMO1:, is searched for a disk content 
file named SYSFILE. If the header for SYSFILE is located in the first 
volume, the data transfer is made. If the header is not found, an 
appropriate error message is issued, and the operation is terminated. 
If the command were entered without the filelabel, the first file of 
disk contents located on the tape on drive MM0O1:, which may or may not 
be SYSFILE, would be transcribed. 


K.6.2 REWIND Switch (/RW) 


The REWIND switch directs DSC to automatically rewind the associated 
Magnetic tapes before beginning any read or write operation. 


If entered as part of the input specification, the /RW switch causes 
the tape to be rewound before the copy operation begins. If a 
filelabel is specified with the /RW switch, DSC searches for the 
specified file of disk contents from the beginning of the first tape 
volume. If no filelabel is specified the first file encountered on 
the tape is copied. 


When used as part of the output specification, the REWIND switch 
causes the copy operation to begin writing data at the beginning of 
the rewound tape. Thus, starting at the beginning of the tape, DSC 
overlaps whatever data were contained on the tape. If no REWIND 
switch is entered with the output specification, DSC begins writing to 
the tape following the first end of file block encountered. 


NOTE 


The REWIND switch can only be used in 
conjunction with magnetic tapes. If 
used with any other device, an error 
message will be issued. 


DSC 


Note that in the following command: 
DSC> MMO1: SYSFILE/RW = DBI: 


the tape of drive MM01: is rewound to its beginning before any data 
are written, and any data contained on the tape are overlaid. The 
data files originally contained in DBl: are written to a single tape 
file identified as SYSFILE. 


In this example: 

DSC> DB1l:=MM0O1: ,MM02:SYSFILE/RW 
A disk is restored using a tape created by a previous DSC _ command. 
The first tape volume is rewound and searched for a previously created 


DSC file labelled SYSFILE. If the file is found, it is transcribed. 
If it is not found, an error message is issued. 


K.6.3 BAD BLOCK Switch /BAD 


The /BAD switch is used in conjunction with output disks to allow 
Manual entry of bad block information. 


There are three variations of the /BAD switch allowing a _ choice 
between manually entered bad blocks supplementing the bad block file 
present on the disk, no bad block data at all, or manually entered bad 


blocks exclusively. The format for the /BAD switch and its options 
is: 
/BAD=MAN MAN 
/BAD=NOAUTO or /BAD=NOAUTO 
/BAD=MAN:NOAUTO or MAN : NOAUTO 
where: 
MAN allows manual entry of bad blocks data which are 
appended to the bad block file present on the disk 
NOAUTO causes DSC to bypass all bad block information for 
the disk, resulting in no applicable bad block 
data 
MAN : NOAUTO uses only manually entered bad block data. 


If either MAN or MAN:NOAUTO are entered as options, DSC prompts 
DSC>BAD= 


and awaits the entry of bad block data by the user. Bad blocks are 
entered by responding 


DSC>BAD = n[,m] 


wheres: 
n is the octal logical block number address of. the 
first manually entered bad block on the disk 
m is the number of blocks that are to be included in 
the manually entered bad block file. (default of 
1) 
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NOTE 


Several sets of bad blocks may be 
entered in this manner. DSC continues 
prompting 


DSC>BAD= 
until a null line (a carriage return 
only) is entered. 
Note in the following example: 
DSC>DB1: /BAD=MAN :NOAUTO=MMO1: ,MM02: /SYSFILE/RW 
DSC>BAD=00702,7 
DSC>BAD=00644,2 
DSC>BAD=04057 


DSC>BAD= 
DSC> 


the output disk, DBl:, is restored from the tape file "SYSFILE" 
contained on MMO1: and MM02:, using as bad block descriptors only 
those blocks specified by the user. In response to DSC's prompts for 
bad blocks following the /BAD = MAN:NOAUTO switch in the command 
string, only the following blocks which were entered in the example 
above will not have data allocated to them: 


00702 
00703 
00704 
00705 
00706 
00707 
00710 
00644 
00645 
04057 


Compare the above example with the following example: 
DSC>DB1: /BAD=NOAUTO=DBO0: 


which transfers data to the lowest LBNs on device DBl:, regardless of 
the contents of the resident bad block file. 


NOTE 


The bad block file contained on a disk 
used with any of the /BAD= switches is 
not overlaid or destroyed; it is either 
supplemented (/BAD=MAN) or ignored 
(/BAD=NOAUTO; /BAD=MAN:NOAUTO) . The 
resident bad block file, if ignored 
during a DSC operation, cannot be 
accessed until another DSC operation is 
performed on the disk. Only at that 
time can the resident bad block file be 
restored. 
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K.6.4 APPEND Switch (/AP) 


The /AP switch causes DSC to begin writing another file to a tape that 
contains an entire DSC-created disk content file. DSC searches the 
first specified output tape for two consecutive tape marks preceded by 
a DSC end-of-file (EOF) block. If the tape is the only volume that 
was used by DSC to previously record an entire disk content file, the 
command is accepted and the new file is begun at the end of the first 
file. If the tape is the second or a subsequent volume of a DSC 
created file, the following error message is returned. 


OUTPUT TAPE AAnn:IS NOT THE ONLY REEL IN ITS SET 
If the following command string is entered, accepted, and processed: 
DSC> MMO1: ,MM02:SYSFILE/RW/AP=DBL: 


the disk files on DBl: will be appended to the DSC-created file 
contained on the first magnetic tape volume specified, MMOl:. In this 
operation, the first tape, MMO-1l:, is rewound to its beginning, and is 
searched for the end of a previous DSC file contained on that tape. 
If an EOF is found for a DSC-created file and the whole file is 
contained on the single volume, the new file, SYSFILE, is appended to 
the tape. If necessary SYSFILE can extend to additional volumes. 


The operation is terminated with an error message if one of the 
following conditions exists: 


1. The file ending on the first specified volume was begun on 
another tape volume 


2. The file began on the volume specified, but extended to other 
volumes 


3. No file ended on the volume. 


NOTE 


The /AP switch may only be used with 
output tape devices. Specification of 
/AP in any other situation will result 
in an error message and termination of 
the command. 


K.6.5 NON-MERGE Mode Switch (/NMG) 


The NON-MERGE mode switch is entered as part of the output 
specification to override the default MERGE mode of copying data. In 
MERGE mode, DSC copies data from disk, an entire file, including 
extensions, at a time. In this mode, all sections of an individual 
File are copied in sequential order, and are then written to the 
output medium before the next file is accessed. 
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NOTE 


Only files written in MERGE mode may be 
accessed through. the RMS RESTORE 
utility. 


The NON-MERGE mode switch affects the order in which data are 
accessed. If the /NMG switch is specified in the command string, file 
sections are accessed and written in the order of their assigned file 
numbers. Each section of a file is accessed and written separately, 
as if it were a complete file. The retrieval pointers in the file 
headers and extension headers are updated, if necessary, so that the 
file sections are correctly mapped. Thus, the /NMG switch does not 
destroy the linkage between file sections. 


While /NMG is specified as part of the output description when copying 
data from a disk, it is not necessary to specify the switch when 
writing from tape to disk. 


Note in this example which uses the /NMG switch: 
DSC>MMO1: ,MM02:SYSFILE/RW/NMG=DS1: 


That the contents of the disk DBl: are written in NON-MERGE mode to 
the beginning of the tapes in the output tape set MMO1:, and MM02:. 
While data compression will occur on each file section when a complete 
disk is restored from the tape set, extensions of a file will not 
necessarily be in contiguous data blocks. 


NOTE 


The resulting tape cannot be accessed. 
through the RESTORE utility. 


In this example of a MERGE mode operation: 
DSC>DB2:=DB1: 


all of the files on DBl: are transcribed to DB2:. The files and file 
extensions are written sequentially and result in contiguous data 
blocks for each individual file in the lower numbered blocks on_ the 
disk. Unused blocks have higher block numbers. 


K.6.6 Density Switches 


Two option switches are provided for TU16 tape drives to override the 
default storage density of 800 bytes per inch (bpi). They are 
discussed in the following two sections. Tape drives other than TU16s 
May be used with DSC, but only TU16 drives may use the density 
switches. All tape drives operate at a default density of 800 bytes 
per inch. 


K.6.6.1 1600-bpi Switch (/DENS = 1600) - The 1600-bpi switch directs 
the TU16 drive to operate as either input or output device at a 
density of 1600 bytes per inch. All volumes written or read by the 
device are accessed at this density. If a tape is written at 1600 
bpi, it must be read at the same density. 
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Tapes recorded at a density of 1600 bpi cannot be used to bootstrap 
the system. A bootstrap block recorded in this density is 
inaccessible by the hardware. If the tape is to be used to bootstrap 
the system, specify the split density option or use the default 
density of 800 bpi. 


The following example illustrates the usage of the 1600 bpi switch: 
DSC> MMO1: ,MM02:SYSFILE/RW/AP/DENS=1600=DB1: 


The tapes created by this example, MMOl: and MMO2: are written at 
1600 bytes per inch. The resulting tapes, even though they contain 
all the necessary information, cannot be used to bootstrap the 
stand-alone version of DSC. The same 1600 bpi switch must be 
specified when the tapes on MMO1: and MM02: are used to restore the 
disk. 


K.6.6.2 SPLIT Density Switch (/DENS=800:1600) - The SPLIT Density 


switch directs the TU16 drive to read or write the entire volume set, 
except for the first two blocks on each volume of the set, at 1600 
bytes per inch. The first two blocks contain the volume header 
information, and the bootstrap block and DSC image; they are accessed 
at a density of 800 bpi. This split in the recording density allows 
DSC to access the bootstrap block and bring a stand-alone version of 
itself into memory, should it be required. 


NOTE 


Although the first two blocks of each 
tape volume are recorded at 800 bpi when 
the SPLIT density switch is specified, 
only the first volume of the set can be 
used to bootstrap the system. 


Consider the following example: 
DSC> MMO1: ,MM02:SYSFILE/RW/DENS=800:1600=DB1: 


The tape created on drive MMOL: in this example can be used to 
bootstrap DSC. The first two blocks of each volume are recorded at 
800 bpi, but only the first volume may be used to bootstrap the DSC 
utility. The remainder of the first volume and of all subsequent 
volumes are recorded at 1600 bpi. If this tape were used to restore 
the disk contents to the disk medium, the SPLIT Density switch would 
have to be identified as part of the input specification. 


NOTE 


The two density switches, DENS=1600 and 
DENS=800:1600, may only be used with 
TU16 tape drives. If specified with a 
disk device, the switches will halt the 
operation and cause an error message to 
be returned. If used with tape drives 
other than TUl6s, the switches are 
ignored and do not affect the default 
density of 800 bpi. If either switch is 
specified when the tapes are created on 
a TU16 tape drive, the same switch must 
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be specified when the tapes are used as 
input. If both switches are specified 
in the same command, the SPLIT Density 
switch will be used and no error will be 
issued. 


K.7 DSC OPERATION 


The sections within this chapter detail the methods of DSC operation 
in each of the four stages of data transfer. 


K.8 DATA TRANSFER FROM DISK 


After the DSC command specifying a disk copy operation is entered and 
accepted, the DSC utility begins the data transfer by scanning the 
input disk to ensure that it is in Files-1ll format. DSC begins 
transcribing data by copying an approximation of the disk index files. 
Because these files are updated to reflect the status and location of 
blocks on a new disk device, the Index File Bit Map, the Storage Bit 
Map File, and the Pad Block File will not be the same on the output 
disk as they were on the input disk. Only the data necessary for the 
reconstruction of these files is transcribed. 


If the transfer is being made under MERGE mode, the file headers 
indicated as active in the Index File are accessed to locate the next 
active prime header of a data file. That header, the blocks it maps, 
and all extension headers and their related blocks included in the 
same file are then transferred to the output medium before the next 
file header is accessed from the Index File. This operation 
continues, each time writing a complete file, until all active files 
have been transferred. 


In NON-MERGE mode each file header, including extension file headers, 
is treated as if it maps all the blocks included in the file. Thus, 
files and related file extensions are not consolidated and written at 
once as in MERGE mode, but are accessed and written individually as 
they are located. 


During this operation, DSC examines only those blocks allocated to 
active files. Unallocated and bad blocks listed in the Bad Block File 
that were formerly interspersed throughout the input disk are ignored 
and bypassed by DSC's operation, resulting in compressed, contiguous 
data blocks on the output disk. When DSC restores the data to a disk 
medium, these blocks occupy the lowest Logical Block Numbers, 
bypassing any blocks listed in the Bad Block File, and the _ storage 
space available for new data is grouped in a continuous area of the 
highest LBNs. 


If, during the copy operation, DSC accesses a data file that contains 
a section written on a bad block, the data on the bad section, however 
garbled, are written as they are read. When the file is restored to 
disk, the blocks will contain the same garbled data, but will be 
accessible to allow restoration by the user. A message identifying 
the location of areas of this type will be displayed on the console. 


DSC 


To copy a disk, DSC performs the following three steps: 


l. Verifies that the disk is online, is identified correctly and 
is in Files-1l format. 


2. Transcribes disk Index Files. 


3. Copies data files. 


NOTE 


Only one disk may be specified as the 
input device in any one DSC operation. 


Output device may be tape or disk. 


K.9 DATA TRANSFER TO TAPE 


When a magnetic tape drive is specified as the output device in a DSC 
operation, the entire contents of the input disk are written through 
it onto tape. This data transfer usually involves more than one reel 
of tape, and may utilize more than one tape drive. 


Tapes created by DSC serve as a backup of the disk contents, but 
cannot be used by themselves, except through the RESTORE utility as 
discussed in Section 1.5.4. DSC tapes can only be efficiently used by 
copying them back to a disk medium, which restores and reformats the 
disk. Although the tapes contain many individual data files that are 
copied from the input disk, they can be treated as though they contain 
a single file - the file of the disk's contents. 


When the operation of copying the disk's contents to tape begins, DSC 
allows transcription to more than one tape. Therefore, the first data 
block written to tape is a header which contains the volume name 
(obtained from the filelabel), and the relative volume number. This 
header identifies the tape volume set and the place within that set 
represented by the volume, assuring that when the disk restore 
operation is begun, the tapes will be loaded in order, and as a set. 


If the system disk itself requires maintenance, or if for some other 
reason DSC cannot be directly invoked, a bootstrappable stand-alone 
version of the utility is provided on all tape volume sets created by 
DSC. The second block of data on the first volume of the set is a 
bootstrap loader and DSC image. 


Subsequent contents of the tapes include the data required to 
reconstruct disk directory files, maps and pointers, and the actual 
data files copied from the disk. 
In order to initiate the tape creation process, the tape devices must 
be on line and correctly identified, and a filelabel must be 
specified. Multiple online tape drives may be specified in the 
following format: 

AAnn(0):, AAnn(1):,...AAnn(7):filelabel = indev: 
as in the following example: 

MMOO: ,MM1: ,MM04:,MM2:SYSFILE=DRI1: 
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As shown, each device identifier is followed by a _ colon, and the 
devices are separated by commas. The last device is followed by the 
filelabel. Only one type of device, 7 or 9 track tape drives can be 
specified in a single DSC command. Up to eight drives may be 
specified per command, but an individual tape drive may be specified 
only once. 


If the number of tape volumes required exceeds the number of tape 
drives available, the system allows replacement of tapes on the drives 
specified in round robin fashion: 


MM1 MM2 MM3 
until the data transfer is complete. 
DSC performs the following four steps when magnetic tapes are created: 


1. Verifies that multiple output devices are on line and are 
identified correctly. 


2. Creates a volume header that identifies volume number = and 
volume set. 


3. Records a bootstrap loader and DSC image. 


4. Transcribes data. 


NOTE 
Input device must be a disk. 
Valid options are 


/RW 

/AP 

/DENS=1600 
/DENS=800:1600 
/NMG 


K.10 DATA TRANSFER FROM TAPE 


Tapes created by DSC can only be used by DSC to -reconstruct a disk. 
When the tapes are mounted and the tape drives are correctly specified 
as the input devices, the tape contents are sequentially accessed and 
written to the output disk. The directory files are created and 
updated as the data are transferred. 


Tape drives specified as input devices must be on line and be 
identified correctly. The tape volumes must be mounted so as to be 
accessed in the correct order. Options that affect the physical 
format of the tapes, specifically the Density switches, must be 
specified as they were when the tape was created. 


DSC performs the following four operations when copying data from 
tape: 


DSC 


1. Verifies that the tape drives are on line and are identified 
correctly. 


2. Accesses tape volumes in order. 
3. Creates directory files. 


4. Transfers data files. 


NOTE 


One must use the same density switches that were used 
when the tape was created. If a filelabel is 
specified, only the disk contents in the tape file 
identified by that filelabel will be transferred. If 
no filelabel is specified, only the first disk 
content file encountered will be transferred. Valid 
options are: 


/RW 
/DENS=1600 
DENS=800:1600 
filelabel 


K.11 DATA TRANSFER TO DISK 


No DSC operation is complete until the data files are restored to disk 
medium. Tape backup files are inaccessible (except through the RMS 
RESTORE utility) until they are written to a disk. Data involved ina 
disk-to-disk transfer are only available after the newly formatted 
disk has transcribed all the input. 


To receive input, a disk must be in Files-1l format, on line, and 
correctly identified. Only one disk can be specified as the output 
device in any single operation. The disk must be large enough to 
contain all the data involved in the transfer, and it must have an 
up-to-date bad block file to ensure accessibility of the data being 
written to the disk. 


DSC requires that the bad block identification file be updated 
immediately preceding the operation. This serves to eliminate the 
possibility of data being written to inaccessible blocks. If desired, 
the bad block file may be supplemented or overridden by manual bad 
block entry through the /BAD switches. 


The copy operation begins with an examination of the output disk to 
ensure that it is in Files-1l format, and that it can contain all the 
data being transferred. The number of blocks being transferred from 
the input device(s) is compared to the number of blocks available on 
the output disk. An appropriate error message will be generated if 
not enough blocks are available. 


The Index and Storage bit map files are constructed on the disk from 
data supplied by the input medium. 


At this point in the operation, the transcription of the data files 


begins. File headers are updated to reflect the new size and location 
of the files. This updating is required since blocks that were 
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previously scattered are now copied to a contiguous set of blocks, 
beginning at the lowest Logical Block Numbers available on the _ disk. 
If the original disk was copied in MERGE mode, file headers and their 
contents, and associated file extension headers and the extensions 
they map are all written to a contiguous series of blocks. If the 
/NMG switch was specified in the original disk copy operation, all the 
data files are written to the lowest LBNs available, but each file 
section is written in the order it was accessed. 


Compression of files in this manner is beneficial when a file header's 
retrieval pointers are almost used up. Since DSC reformats a disk so 
that large numbers of contiguous blocks are allocated to a single data 
file, the number of retrieval pointers required to map the location 
and length of the file contents can be significantly reduced. If the 
original data transfer is made in MERGE mode, it is possible to reduce 
the number and size of file extensions and extension headers. 


When the DSC operation is concluded, the allocated blocks occupy the 
lowest LBNs available on the disk. Blocks that are available for use 
generally have higher LBNs, and are in a contiguous section as well. 


It should be noted that DSC, when writing to a disk, begins 
transcribing data onto the lowest LBN possible. Data present on the 
disk in this area are overlaid by the new data. Therefore, DSC cannot 
be used to transfer several smaller disks' contents onto a single, 
larger disk. Each copy operation will wipe out whatever previously 
occupied the blocks being used. 

DSC performs the following procedures when creating a disk: 

1. Verifies that the disk has an up-to-date bad block register. 


2. Verifies that the disk is in Files-1l format, is on line, and 
is identified correctly. 


3. Verifies that the disk has enough available blocks to contain 
all the data involved in the transfer. 


4. Creates index and directory files. 


5. Transcribes data files. 


NOTE 


Any data originally contained on the specified output 
disk is overlaid. 


The /NMG switch can be specified with an output disk, 
but may only be used when the input device is also a 
disk. 


The /BAD switches may be used to override or 
supplement bad block data or the output disk. 
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K.12 DSC ERROR MESSAGES 


DSC prints out many messages on the console that provide information 
on errors, problems, or potential problems encountered in the DSC 
operations. Each message is prefixed with: 


DSC-- 


to identify itself as a DSC error message. In most cases, the above 
prefix is received in conjunction with a message identification type: 


DSC -- *WARNING* error messge text 
Or: 
DSC -- *FATAL* error message text 


followed by a diagnostic error message. In the first example above, 
where a *WARNING* is received, the DSC operation in effect at the time 
will continue after the message is received. If a *FATAL* message is 
issued, the current DSC operation is aborted and DSC prompts for a new 
command line. 


In some cases a message will be received that is neither a *WARNING* 
nor a *FATAL* message. Usually these are instructions to DSC users 
who must comply with the instructions to continue the operation. 


The messages themselves are listed below in alphabetical order. The 
text of the message is shown first, followed by the meaning of the 
message, and concluded with instructions on what should be done to 
alleviate the condition. 


DSC 


*peq ST adeq asta 
‘sobessow Bbutuizem O/I 
Kq pepeoseid jt A104 


‘gouo0 ATuo 
petgtoeds aotaap yuyTM butiz4s 
puewwods JaqUue-a1 SUL 


*uotqzeredo ayy A104 


*yaqjue—-a1 pue TaTJIWUSpPT 
aoTAep ey} yAosUD 


*yeuroy TI-SeTTd UT st eu 
soOTASP zsyjzoue asf 


‘apts Bbutiqs puewwods e uo 
petgtoeds st edAj adTaaep 
auo ATuo yey OS Sbhueyo pue 
‘6Huti3s puewuos yoayd 


‘uotzerzedo Adoo 9sa 
JO} pepesu suo 3yy ST 
odeq ayy aains ayeN 


‘atqtrssod Jt 39a1109 ‘yxDOTA 
eqep ayy outwexg 


*Kay uanjed 
abetaieo ayy 3ASTT pue edeq 
petstoeds uo butdr yAasul 


NOILOW daLSsadSons 


“ASOT aq 03 TTF petsztoaeds 
sosned Joris peed ederz 


*go0u0 ueyy sir0U 
petgtoeds sem adTAep ewes sul 


*zO11a Teura\UT 


‘pasn buteq weqsAs 
UT seoTAep Tersydtied eyz Jo suo se 
pautequoo you ST aoTAep petgztoeds eyuL 


“qewzoz TT-SeTtd ut 
qou ST adTAep patstoeds oul 


*Hutaqys puewwoos 39yy JO apts sues 
ay} uo petytoeds ere ‘aATip ode pue 
¥StTp se yons ‘sadAqz aotaed 


*AQIsuep asjzeuTwWIszZepuTt ue 7e 
papzooez sem 4T ey uoSseet 

ay} 10FJ pasn oq youued seATIAp edey 
paetytoeds ayq uo edeq yndut euL 


*snoosuoiia ST 
zeyy e}ep SUTeIUOD adTAep pezI0de1 
ayy uo patytoeds yooTq e3ed 


*peqaesut st buta 


aTqeue eqyTIM e TT}#UN Uo UdzATIMA 
eq Jouued:UuUYY eATIp UO adeq 4nd3zno 


ONINVGW 


#°OSS @IId # ATI ‘GI ald 
- :uuyw NO LNaSdud LON 
MAAVSH NOISNELXA daLoadXxa 


GWYN SOIAIA ALWOITANG 


MOUNT AATLOIAIG 


WALSAS 
NI LON SI :uuyy goOIAad 


Ti-Sd1ld 
LON SI *uuvW aoTAdd 


SHdAL FOIAIA ONILOITANOO 


. suuWW NO ddWL dO 
ALISNAG ANIWYALAG LONNVO 


X NdA 
‘ONS ATIa ‘# ATIA ‘GI Ald 
suuWW NO MOOTd Wivd avd 


NAUMLaa LIH GNW ONIX aALIYM 
LYaSNI ‘GSMO0OT ALIUM SI*uUvW 


aDVSSaW YOUN 


K-16 


DSC 


*SATIP BOTADSP 
Mou uo Arq 4A130uN 


“sOTASpP 94 JZUNOW 


*paazainosso sey rzoiize Aqtied 


*pequnow Jou ST SsdOTASdG 


AOIAGG NO WONNA ALIUVd 


AQVdaY LON dOTAdG 


‘10119 ayy 


sasned 3ey UOTITpUuODS 4ynd3no Jo yndut ayA yno AuTOd sabessaw O/I HutMoTToJ 


euL *uoTqzeirado 
sebessouw osaq sul 


uot3jounfuod ut 


*puewwoos 343 19}Us-97 
pue TeqeTeTTF yxoayD 


*uoTqerzedo ayq A139u 


*qUdeYSTSUOSUT ST 
YSTP OSTe JO ‘1017198 O/I 
butpeaceid jo ytnsaz ATTensn 


*uotzereado A13ay 


*yYSTp abueyo 30O ‘SsaaTiIp 
y¥Stp ebueyo !A1X290y 


*aoTAEp 
patztoeds aoetday 


NOILOV GaLSa59ns 


aLON 


*peatgtoeds useq sey siaqoerzeyo 
ZT ueyz eTOW JO TeqeTeTTF W 


*saoqe se sowes 


*¥STp yndut 
woij Hutpesar usym 
punoj jou Aepeaey uotsuezXxe seTtd 


“3SOT ST OTTA “ASTP OF STTF 
petgytoads HbutAtzM ut AduaystTsuoout 


*peq ST YOOTq ewoy IO ‘peq ST ¥STP 
TI-SeTTd JOU JayATe ST ySTp 3eUR 
Hbuluesw ySTp wory 3o1za pesy 


*peqzeeaio aq 


Jouued YyooTq suoy ‘43nd3no ay uo 
syootTq peq Auew 003 03 ong 


ONINVAW 


Osa eyRz uo sey 10178 O/I sy FOSaTJS ayR a}eIZSUOUAD 
*szo1z7a O/I se patytoeds sahbessou 
PeATI0eI 


Joqjia OSG YTM 
aie sabessow 101279 4nd3no 1oO 4nduTt HbutMoTToOF ous 


ONOT OOL SI THEVTETIA 


#°OaS ‘#39714 
‘G1 S1TId WaLIv:uuww 


NO 4SVHd dO LNO YACWEH ATI 
#°Oas 

‘# ‘QI eTTd suuvY NO YdaqvaH 
NOISNELXY ATIA GWG OL Ga IIvd 
#°OaS‘#’AI aITId-:uuyy uo 

aIId DNAdLNO dVW OL daTIvd 


suuUVWY NO MOOTd 
AWOH GNId OL ddalivd 


suUVW NO MOOT 
ANOH ALYOOTTY OL daTIvd 


aOVSSHN YOUN 


K-17 


DSC 


‘uotjzerzedo ayq A1r4eu 


*SsATIp 
Mou uo A1rzey 


“suOoTQeOTJTOOdS adTAAaDp 
pueuwwos yooayD 


*uotjzerzedo ayq A124 
*uotTqersdo ay Arz9ay 


*SOTAIAS plata 
TWLIDIG TTeo !A1304 


*uoTzeredo 
ayy Ar1zey 


“SsATIP ASTD 
Jo/pue ¥STp 
Butbueyo ‘A130u 


*ubtezioy se Qunou 

‘YSTp eu JUNOUSTp :Ssiosn 
wa jsAs z3ayjzO pue SVI 
2ySTp ay Junouwun 

:siasn WIT-xsu 


suotTzerado ayy A104 
*SsATIAp 


ayy yOoT 3a4TrMUN 


NOILOW daLSadons 


*papeoTieao st weqsks butqjessdo 
*zoazo Aqtied 


*weqsAs ay UT Jou adTAEq 
*4ysoT uotjtsod ader 


*3SO[T uoTAITSod adeyz 


*uoTAZOUNFTeW s7eMpPAeH 


*AVTTTQtTzedwuoout 
adejz zo fuotjzounsTeu sotaAsqg 


*peq 


ST ¥STp 943 JO !paeazandd0 sey 10110 
sa e !y¥STp uo YSTxe JOU SaOp YOOTA 


*LI-Se1TTd se pajunow st sdTAeEd 
*qZeUIOJF FOSXIIOOUT 
1o uotjtsod jo 4no-7017e adeL 


*payOOT O4TIM ST SATIP AST 


ONINVAW 


aoWdS 100d LNAIOIMANSNI 


MOHD MOOTE 


AaNITAMIO FOTARG 
GaL0aLad AWNIOA dO GNd 


GagLoaLad ATId dO ANd 


YOUN AUVMGYVH IWLVA 


aOIAgG NO WoOTd dvd 


MAaWON AoOTA Avda 


NOILWIOIA dda TIATYd 


NNYadAO VLVd 


GaM00T ALIYM FOIA 


aDVSSHN WONNA 


K-18 


DSC 


*pataqzaar aq 
PrInoys uotjerjedo aiatqjua 
‘KTuo abessow buturem 


“uotjze1rado 
aatque Azzo9y 


*SATIP 
ASTp Mou uo AIrjaY 


*Kayzeir 
pue IJOIIS 4997710) 


*and90 s10147a Jay RO 
ssetun Azessadau uot zoe 
on *ATuoO butuszem 


*SATIp adeq 
zayjzoue uo Aqjoey 


O/I se petzytoeds 


*uotjeizedo ayq A13ay 
*uotTjyezado ayy Aijay 
*JaTpuey sdTaap 


ajzetidoidde ayy peor 


NOTLOW daLsa55ns 


*AUM STTE4 10IIE O/I 

HUIMOTTON *3SOT ST eTTd *Japeey aT 
butpeer ut 3JO17a ‘ySTp 03 HutTzTIM usUM 
“FSOT ST OTTFS 

petytoeds *‘adeq Hburtpeez zo0ojzia 
SeTzJtTOeds AJOIIe O/I HuTMoTTog 


“SMOTTOJF abessauw s017e 
O/I ‘¥Stp butpesr wetqoid 


"OF USqQqTIM aq 


Jouued petsJtoeds aotaaep Aym sutetdxe 
abessow 10179 O/I ButMoT{tog 


*SIOIISa TeuoTjtppe 
asned Aew AOIIa O/I BurMottog 


ade} patytoaeds ‘Bbutpear uaya 
perinds5s0 (SMOTTOF YOTYM) OITA O/I 


ALON 


*3SOT uoTATSOd adez 


“10119 O/I aTqeutjyepun 
“pepeot ou ST AsTpuey sdotaegd 


ONINVAW 


#°OaS ‘# ‘AI aTId:uuvw NO 
UAGdWaH ATIA ONIGVAY YoOUUNA O/I 


#°OaS ‘# ‘aI 


AITId YaLdv:uuwwW NO UYsdaVvaH 


A3TId ONIGVWSY WOUNA O/I 


suuUVW NO MOO'Td AWOH 4O 
LOOd ONIGVAN YOUU O/I 


suUuUYW 


HJOTAYG GNdLNO NO woud O/I 


SuUYW 


aHOITAdd TNdNI NO woud O/I 


*uuUYW NO STHaVI 
adV~L LAdNI NI WOUNa O/I 


*"SI0119 


sebessow JO1I@ OSA YIM PaATedeI |1e sabessow saoge auL 


daLoabad adWL dO Na 


youwa WALSAS NMONYNN 


DNAGISHd LON aa Ianv 


HOVSSAW YOUU 


K-19 


DSC 


*uoT3zeiado opey 


*Kaqzea '10119 
JO JuazZXS yOaYUD 


*uoTqzeredo aitjue 
ayy Aaqzai ro ‘aATIAp 
mou uo A1rqAay 


“ASTD 
mou uta ArqaYy 


*YOTIMS 30081700 
URIM JaqUe-—say 


*uotqeiedo Arj9u | 


*uotqzerado A1rjau 
*uotyerzado A139" 
*uotjzeredo a1itjua 


Aaje1 Jo ‘aatip ade 
zeyjzoue A1rz9y 


suotqzezodo A13ay 


suotqzerzado A130u 


NOILOW GaLsad5ons 


"3SOT ST OTTd 
*squaquod rapeey peq o3 eNp YASTp 
WOIT ATTJF patstoeds buTpear 10119 


*asoT aq Aew syooTq e ep 


aWOg *UOTRBOOT pue aTTJ patstoeds 
HuTpeeI STTYM SOT uoTATSOd sdeL 


‘adeq peq 3o ‘ade Hbutpesi 10119 


*y¥STp ynd3jno uo syd0Tq peq Auew 
00} JO asnedeq pazinososo 10119 


*pasn aq jouueos zeYyy YoRTMS 
e sutequoo butiqs puewuod eyL 


*@TTy ebezoys 
BUTATIM STTYM paazinoso JorIe O/T 


“OTTF XeputT 
HUTATIA STTYM pazind90 10172 O/I 


*Japesy eTts 

HUTATIM eTTYM pazinoso 101Ia O/I 
; *seTtg dew ebe1i0js 
pue xeput e103sez1 03 edeq butpeez 
@TTYM paezINd90 10119 O/I 


“¥STp buTpeeaz STTYyM 
perzino90 ‘SsMoTTOF 10118 O/I 


“y¥STp butpeaz eTTym 
pazinooo ‘sMo{[TTOJ 10139 O/I 


ONINVAW 


MOUNT WOSYOATHOD UAGWAH ATIA 
‘g ‘QI aTIg:uuyy AOIAgG LAANI 


K GNNOd X GaLOadxXd 
‘NGA‘#09S#‘GI aTId?uuvv 
NO SSVHd JO LNO WLvd LNdNI 


suuwW uo 
IN@SaYd LON WLWd S3TId XaaNI 


:uuyW uO 
FUN TIVd NOILVOOIIY agTId Xdant 


HOLIMS IWDaTIL 


suuvW NO dTId 
dWW ADVYOLS ONILIUM wouNa O/I1 


suuvW NO dwWLId 
@TId XSQNI ONILIUM woud O/I 


#°Oas ‘# ‘GI aTId:uuvw NO 
UHGVAH AIIA ONILIUM woud O/I 
ruuvw WOUd WLVd 

RKUVWWOS ONIGWad woud O/I 


suuvW WOUd VWLVd 
Ald XHONI ONIGvVaY woUuda O/1 


suuvWY NO dWWLId 
aIId XJGNI SNIGVaY YOUNT O/I 


AOVSSAN Youd 


K-20 


DSC 


*jutod peot ye 
q1e3s ‘jUuNnOWsaY 
*uotyzeiado ay opeay 


*odeqz yndut 
aBbueyo pue yoayuD 


‘QSAITJ SWNTOA 


asaty Ajtoeds ‘butazqs 
puewwods JojUus—ay 


*uotqzerzedo A13ay 
*sabessow rz011a 
quenbaesqns Aq pa zeotput 
UOT}Oe MOTTOU 
*uotzeredo ayy Arey 
*uotjerade ayy Arjqay 


“SATIP ASTP 
JO ¥STp abueyo 


*paatnbaz uotzoe 
ON ‘ATuo butuiem 


*uotzer1ado opay 


NOILOW daLsad5ons 


*quTOd peot 
3e Jou adeq patytoaeds 


*FSOT ST ATT patytoads aerojzeq eyep 
auos ‘3SOT uoTjATSsod ade, 


*qeUWIO; 
308110O0UT UT ST 9odeq yndul 


*aouanbses Jo yno ade 


“3SOT 
ere yAu JO TTP pue xX, JO Jeputewusy 
‘odej Hbutpear aTTYyM ASOT UOT ATSOg 


*(MOTTOJS sabessauw torre 139430) 
“SOT 8q TITM SATTF owosg *-adeq 
gndut butpeear aTtym 3SOT uoTATSOg 
‘udsy¥OIGQ ST eHbexUTT uot AoSS aTTd 


“SOT ST OTT patytoeds 
*"usyOIq ST SHExYUTT UOTIOeS ATTA 


“¥STp gndut 
BuTpeed STTYM eTTJ puty YouueyD 


*peqtziosuej} jou 3nq ‘passasoe 
ST pebbeTy 10 payetap AtTerqzied atta 


*¥STpD WoIJ pear rapeay 
atty Aqtney 07 ONp ASOT st atta 


ONINVAW 


LOd LV dd 
LSOW?UUYWY NO ddVL LOdNI 


#°OaS ‘# ‘GI ATId LV 
GHZINOWHONASSY*uUYW AdVL LOdNI 


LYWYOd ISNW 
LON SI?uuvW ddVL LOAdNI 


ddVL NOILWANILNOS 
VW SI?:uuwy adWL LAdNI 


“KR GNNOd ‘X GaLOadxXd 
‘# O9S’# ‘AI gTid:uuvy 
NO dASVHd dO ~LNO ATId LNAdNI 


GaZINOWHONAS AG TIIM 
# ‘GI aTIa:uuvyy ADIAKG LNdNI 


MOSHOD USEWON LNSEWOAS 
‘# ‘pT eTTz:uuvy ADIAIG LOANI 


ZBNASSYd LON SI ‘# 
‘GI ¢IId:uuyy FOIAGG LOdNI 


dadida Tad Sst 
“#'CI @TId:uuvyw dOIAga LOdNI 


MOHHOD UAAGWON AITIA #0gS 
‘#/qI ATId:uuwv dJOIASG LOdNI 


ASVSSHW YOUU 


K-21 


DSC 


*adeq yndyno abueyo 
‘pueuuios raqUseY 


*popssu aq Aew ySTp Mau 
‘uotjzeisedo opay 
*¥STp 3ndyjno Meu YATA 


uot jezsdo opay 


*ATuo butuzem 
‘paatnbaz uotqoe ON 


*puewwod Jejue-ay 
BOTAap Mau 4a5H 
*2a0TASep Mau AUNOW 


*SATIp adeqj Mau uo 
uotjzerzedo A194 


*puewwoos Azjzai ‘ySTp 
uo avd und 


*poAertdstp 
SUOTROSITP SYR MOTTON 


*adAj aatip adeq 
‘auo Atuo Ajztoads 


*puewwods ayy 

Aija1 pue ysTp 

Mou 3906 IO ‘ySTp uO 
ARTTTIN ava uny 


NOILOV daLSaoons 


‘Jes e JO SWNTOA 4SATJ ueYyy 19YRO 
03 puedde qyouueg ‘puadde TebeTTI 


“3SOT ST OTTA “ASTD 
03 Hut3ztTIM wetqoid Asusystsuo) 


*4SOT 


ST eTTa ‘syo0Tq peq Auew 003 03 
anp e}ep Jepesy eTTJF yueysTsuooul 


*peq St 9 Jequnu YyooTE 


*Azojzeuetdxa jJTes 


-Xzojzeuetdxs jjTes 


*3SOT ST OTT patztoeds 
‘eqep Butpeer aTtTymM 4ysoT uoTAITsod sdeL 


*™aSTp 4yndyno patsztoeds 

ayy uo SISTXS STTF ASOTG peq ON 
*Xiaozeuetdxs jjTas 

“Butaqs puewwos 


awes ay} uT petytoeds yjoq a10M 
*aATIp edey yor1zq-6 JO/pue -1 ¥ 


“PITRAUT ST 
¥STP yndyno uo aeTTF yOoTG pea 


ONINVAW 


adVL NOILVANILNOO 
W sl:uuvy addvVL LAdLNo 


# ‘GI A3ITId-ddddvWW LON 
:uuyW NO UsdWaH BIId LOdLNo 


# ‘GI a@TId: uuvy - 


NO TINd UIACVAH ATId LAdLNo 


a TdvLOod 
LON sl:uuyy xsid LAdLNO 


iGI 3SN LON Od ‘WOVd OILSONDVIG 
W Sl:uuwvW aoIAgd LOdLNo 


(# ‘aI STI4) 
TYInNasuuvY AOIAGG LAdLNO 


#NGA ‘# ‘GI aATIa:uuyy 
NO GSYSLNQOONA WOOTA WLVA-NON 


suuYvW 
NO wLvd woOold avd ON 


NYONLad LIA GN 
suuvyW NO X Tddu LNOOW 


SHdAL JAINA ddVL GaxIW 


suuvYY NO 
WLVG Woold dvd dAIIVANI 


aOVSSAN Youd 


K-22 


DSC 


*Krjoy 


‘apts red saotaap 
34ubTS Fo wnutxew 

2 UTM HutjzAs 
puewwos raque-ay 


*“puewwods As jUs-97 
‘TeqeTeTTF yoeyo 


*ATWOeIION Ads\ua-aIq 
‘puewwods yoayud 


*pueUWwod 

auy JajUusa-daI pue 
qutod peot 3e yas 10 
adeq au junowsy 


‘ade 
ynd3no mau Ajztoads 
puewuods rajUuse-ay 


“YOR TMS 
dv/ Aytoads you op 
‘puewwods rd}Uua-ay 


“YO TAS 
dvw/ Aytoads jou op 
‘puewwod TajzUuse-sy 


*adeq 3andjno ebueyo 
‘puewuods ajUe-ay 


NOTLOW daLSa59ns 


‘10119 9yi Ajytjuapt 
0} aTqeun ‘pazajunoouse 101149 


*puewwods ay} JO Apts BuO uO petstoads 


udseq eAeYy Sa2OTAAapP AYHbTSe ueU sI0W 


“punoz 30U TeqeTeTTF petztoads 


*JewrOF Hutzzs puewwoos ut 310319 


*QuTod peoT ze 3ou adey 


*puedde rebat{ti 


*pusdde [ebeTTI 


*pusdde [ebeTti 


"ade 
petstoeds 03 puedde youuez 


ONINVGW 


woudd GANIAFaNNn 


SdHOTAGG ANVW OOL 
*uuYY NO GNNOd 
LON wzANWNATI4, FTId Fdvh 


woOudd XVLNAS 


LOd LY LON 
SI?uuvW NO ddvVL LNdLno 


LAS SLI NI Iau AINO 
4HL DON SI tuuwy advil LOdbno 


LVYWYOd ISNW 
LON ST?uuYW AdvVL LOdLtno 


ddVL OSd W 
DON SI?:uuvy ddVL LNdino 


TTOd SI*uuWY FTdVL LNaLNo 


AHOVSSAN YOUN 


K-23 


psc 


*perapiz0 
AjT}0e1109 sadez yyIM 
puewwods 1a\Uus—ay 


*uotTze1rado 
ayy A1370u 


NOILOW daLsadSons 


*agouenbas Jo 
4no patytoeds sede3 andulL 


*odeq y4ndut 
paetytoeds woiaz ejep eqeTdwooul 


SNINVAW 


THdV1dTId 
aNood ‘ISdWISIId ONILOad Xd 
zuuvW NO adVL LNdNI DNOUM 


suuvW NO LNasddd 
LON WLVG AYWWNOS AWNTIOA 


aDvVSSAW wouda 


K-24 


Allocation of, 
device buffers, 3-18 
directory, 3-7, 3-24 
disk blocks, 6-5 through 6-9, 
6-17 through 6-19 
Arithmetic conversion tables, 
E-1 through E-13 
ASCII code, 2-16, B-1l through B-3 
Associated documents, xi, xii, 
1-4 


Backslash (\), xiii 
Backup and Utility system, 1-4, 
4-8, I-l through I-20 
Backup copies, 4-8, 4-9 
system disk, 2-12, 4-11 through 


4-13 
Basic System Build, 2-1, 2-2, 
2-10, 2-13 


answering questions, 2-9, 2-15 
through 2-19 
loading System Builder, 2-6 
through 2-8, 2-14 
object modules, 2-8 
overview, 1-2 
running SYSBLD, 2-14 
Basic System configuration, 3-1 
Baud rates, 3-7, 3-28, 3-31 
BCS (Broadcast) System Utility 
program, 6-2, 6-3 
Bell-type 103A datasets, 2-17 
BREAK (Break key symbol), xiii 
Buffer allocation for devices, 
3-18 
Building the Basic System, 2-1, 
2-2, 2-6 through 2-8, 2-10, 
2-13, 2-14 


Carriage return, xv, 3-2 
Character deletion, 2-3, 3-10 
Character set, B-1l through B-3 
Clock timing, 3-35 
Closing system, 4-3 
Command terminator, xiii 
Connection procedures, 
non-standard terminal devices, 
H-1l, H-2 
Console terminal, 3-5, 4-1, 4-2 
function, 4-5 
Controllers, 3-5 through 3-7 
Conversion tables, E-1 through 
E-13 


INDEX 


CPU device, 2-18, 3-7, 3-19, 
3-28 

Crash condition, 5-6 through 5-9 

Creation date of system, 3-35 

Creation time of system, 3-35 

CTK (Caretaker) System Utility 
program, 5-5, 6-2, 6-4, 
6-10, F-1 

CTRL (command symbol), xiii 

CTRL-U or U, xiii, 2-3 


Datasets, Bell-type 103A, 2-17, 
3-27 

Date of system creation, 3-35 

DAT (Date Set) System Utility 
program, 6-2, 6-5 

DBDGD error, 5-4 

DBT (Disk Block Tally) System 
Utility program, 6-2, 6-5, 
6-6 

Deallocating disk blocks, 6-17, 
6-18 

Debugging, 4-5 through 4-7 

Debugging aid message, C-4 

DECtape Test (TP5), 6-28 

Default values for terminal 
parameters, 3-27, 3-28 

Deletion of character or line, 
2-3, 3-10 

Device assignment, 3-5 through 
3-7 

Device availability for I/0, 
3-14 through 3-18 

Device buffer allocation, 3-18 
through 3-20 

Device driver object modules, 

loading of, 2-6 through 2-8 

Device driver program, 2-2, 2-3 

Device interrupt vector locations, 
3-8 

Device parameters, terminal, 
3-25 through 3-28 

Devices, I/O, 2-2, 2-3, 3-5, 
3-14 

Devices, reserved, 2-2, 2-3 

DH-11 Multiplexer - see Multi- 

' plexer 

Directory allocation, 3-7, 3-24 

Disk-block allocation/ 
de-allocation, 4-3, 6-5 
through 6-9, 6-17 through 6-19 

Disk hardware failure, 5-2 

Disk inclusion, SYSGEN, 3-22, 
3-23 


Index-1 
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Disk memory, 3-4, 3-11 

Disk pack as system device, 3-9 

Disk packs, 1-4, 3-4, 

distribution, 2-12, 2-13 

DKDER error, 5-2 

DKHER error, 5-2 

DKSER error, 5-2, 5-4 

$D Library Utility program, 3-35 

DMC-11 Controller, 3-19, 3-27 

DMP (Disk Block Dump) System 
Utility program, 6-2, 6-6 
through 6-10 


Documentation included in MUMPS-11 


software package, 1-4 

Documents, associated, xi, xii, 
1-4 

Drivers, - see Device driver 

Drives, number permitted, 3-11 
through 3-13 

DSKDG error, 5-4 

Dump program (DMP), 6-2, 6-6 
through 6-10 

DZ-11 Multiplexer - see Multi- 
plexer 


EIS Extended Instruction Set, 
2-16 
Error checking, utility programs, 
6-1 through 6-28 
Error conditions, 2-3 
SYSGEN, 3-10, 3-11 
Error detection and recovery, 
5-1 through 5-10 
Error messages, C-1 through C-4 
operating system, C-5, C-6 
Errors, 
bus timeout, 5-8 
Garbage Collector, 5-3, 5-4 
hard crash, 5-6 through 5-10 
hardware, 5-2, 5-5 through 5-9 
illegal instruction, 5-8 
logical, 2-3 
memory parity, 5-8 
operating, 5-1 through 5-3 
programming, 5-1, 5-2 
segmentation, 5-8 
soft crash, 5-6 through 5-9 
software, 5-2, 5-8, 5-9 
SYSBLD, 2-3 
system table, 5-5, 5-6 
typing, 2-3 
Expression Evaluation Test (TP3), 
6-28 


Fixed head disk, 3-4 
Floating-Point Processor, 2-15 


Garbage Collector errors, 5-3, 
5-4 

Garbage Collector routine, 4-1, 
4-3 

GARBO error, 5 

GARB1 error, 5- 

GARB2 error, 5 

GARB3 error, 5 

GARB4 error, 5-3, 5-4 

Global Test (TP8), 6-28 

Glossary of terms, A-1 through 
A-7 

$GP (Global Place) System Utility 
program, 6-3, 6-25 through 
6-27 


Hard crash, 5-6 through 5-10 
Hardware configuration, 2-2 


Inactive jobs, 6-14 

Initialization program (STU), 
6-25 

Interpreter disabled, 4-4 

Interrupt vectors, 3-29, 5-7, 5-8 

I/O devices, 2-1, 2-2, 3-5 

availability of, 3-14 through 

3-18 


Job number, 6-21 
Jobs lost or inactive, 6-14 
Job status, 6-21, 6-22 


KTR (Caretaker Reporter) System 
Utility program, 5-5, 6-2, 
6-10, 6-11, F-1 


Language Functions Test (TP1l), 
6-28 
Library Utility programs, 1-3, 
1-4, 3-22, 3-23 
Line deletion, 2-3, 3-10, 3-11 
Line Printer/Terminal Test (TP4), 
6-28 
Line terminator, xiii 
Loading, 
object modules, 2-8, 2-9 
system, 4-10 through 4-12 
System Builder, 2-6 through 2-8, 
2-13, 2-14 


Index-2 
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Loading procedure, 
Magtape, 2-6 through 2-8, 3-8, 
3-9, G-l 
SYSGEN, 3-8 through 3-10 
Logical backup, 4-8 
Logical errors, 2-3 
Log-in, 2-6 through 2-8, 3-9, 3-10 
Lost jobs, 6-14 


Magnetic Tape Test (TP6), 6-28 

Magtape loading and unloading, 
2-6 through 2-8, 3-8, 3-9, 
G-1, G-2 

Magtape transport controls, 3-8 

Materials required for system, 
1-4 

Mathematical conversion tables, 
E-1 through E-13 

MBU (MUMPS Backup and Utility 
System), 1-4, 4-8, I-1 
through I-20 

Memory availability, SYSGEN, 
3-11, 3-12 

Memory buffer space, 3-18 through 
3-20 

Memory size, 3-4 

Merge, System, 2-13, 3-11, 3-12 

Messages from operator, 6-2, 6-3 

SMONEY ($M) function, 2-16 

Mini-ODT, 4-1 through 4-7 

Miscellaneous SYSGEN information, 
3-33 through 3-35 

Modules (binary files), 2-1 

MSB (MUMPS-11 System Builder), 
2-1, 2-2, 2-6 through 2-8, 
2-10, 2-13, 2-14 

MSP (Modify System Parameters) 
Utility program, 6-11, 6-12 

Multiplexers, 2-17, 3-5, 3-6 

availability, 3-17, 3-18 
operating parameters, 3-28 

through 3-30 


NAKED error, 5-2 

Nodes, F-1 through F-3 

Non-standard terminal device 
connection procedures, H-l, H-2 


Object modules, 2-1 
user created, 2-8, 2-9 
Octal debugging program (mini-ODT), 
4-5 through 4-7 
Operating system errors, 5-1 
through 5-4, C-1, C-5, C-6 


Operation of SYSGEN, 3-3 

Operations summary, 2-1, 2-2 

Operator functions, 4-1 through 
4-13 

Optional modules, 2-1 

Overflow between disk units, 3-34 

Overflow, program and global 
disk, 3-7, 3-8 


PAC (Program Access Code) modi- 
fication, 3-23, 3-25 
Parity generation, 
for multiplexer, 3-30 
for paper tape I/O, 3-28 
Partitions, 3-4 
allocation, 3-4, 3-20 through 
3-22 
data, 6-20 
granting, 4-3 
sizes, 3-4, 3-5, 3-18, 3-20 
through 3-22, 3-25 
PDP-11 documentation, xii 
PDP-11 processor, 2-2 
hardware configuration, 2-2 
switch register, 4-1 through 
4-4 
Physical backup, 4-8, 4-9 
PLDER error, 5-3 
Power line frequency, 3-33 
PRESERV, J-1 through J-12 
Program initiation, 6-1 
Programming errors, 5-1 through 
5-4 
messages, C-1 through C-4 


Questions, SYSBLD, 2-15 through 
2-19 
Questions, SYSGEN operation, 3-3 
buffer allocation, 3-18 
device availability, 3-14 
through 3-18 
memory availability, 3-11, 3-12 
miscellaneous information, 3-33 
through 3-35 
modify terminal, 3-25 through 
3-28 
modify UCI and PAC, 3-23 through 
3-25 
multiplexer, 3-28 through 3-30 
partition allocation, 3-4, 3-20 
through 3-22 


Read errors, 5-3, 5-4 
2-2 


Reserved devices, , 2-3 


Index-3 
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Restart of system, 4-10, 4-11 
Restoring system disk from backup, 
4-8, 4-9, 4-11 through 4-13 

> (right caret or right angle 
bracket) prompting symbol, 
3-9, 3-10 

RKC (RK Disk Copy) System Utility 


program, 6-2, 6-12 through 6-14 


RK distribution, 2-12, 2-13 

ROM bootstrap-loader starting 
addresses, 2-3 through 2-5 

RSJ (Restore Job) System Utility 
program, 6-2, 6-14 

RST (Restore Terminal Devices) 
System Utility program, 6-2, 
6-15, 6-16 

RUBOUT key, xiii, 2-3, 3-10 


Save crash block, 5-9 
Saving system image, 2-12, 2-19, 
3-35, 4-9, 4-10 
Shutdown of system, 4-13, 6-23, 
6-24 
SDP (Sequential Disk Processor) 
System Utility program, 2-16, 
6-3, 6-17 through 6-19 
SIF (System Information) Utility 
program, 6-3, 6-20 
Soft crash, 5-6 through 5-9 
Software documentation package, 
1-4 
Software, 1-1 through 1-3, 2-1 
Space (symbol used to indicate), 
xiii 
SS (System Status) Utility pro- 
gram, 6-3, 6-21 through 6-23 
SSD (System Shutdown) Utility 
program, 4-13, 6-3, 6-23, 
6-24 
Stack growth, 3-8 
Stack limit register, 3-34 
Stall counts for DIGITAL 
terminals, 3-27, 3-28 
Starting addresses, ROM bootstrap 
loader, 2-3 through 2-5 
Starting, 
Basic System, 2-6, 2-14 
SYSGEN, 3-8 through 3-10 
the system, 4-10 
Status information, 6-21, 6-22 
Stopping system operation, 4-3 
Storage areas for directories, 
3-7 
STU (System Startup) Utility 
program, 6-3, 6-25 
SWAP error, 5-3 
Switch register usage, PDP-1l, 
4-1 through 4-4 


Switch settings, 3-10, 4-10, 
Symbol usage, xiii, D-1, D-2 
SYSBLD (System Build) program, 
2-1 
examples, 2-1, 2-2, 2-6 through 
2-8, 2-10, 2-13, 2-14 
questions, 2-9, 2-15 through 
2-19 
SYSDG error, 5-3 
SYSER error, 5-4 
SYSGEN (System Generation), 3-1 
error conditions, 3-10, 3-11 
loading procedure, 3-8 through 
3-10 
operation, 3-3, 3-11 
organization, 3-1 
start, 3-8 through 3-10 
tape distribution, 3-2 
SYSGEN questions, 
answering, 3-3 
buffer allocation, 3-18 
device availability, 3-14 
through 3-18 
memory availability, 3-11, 3-12 
miscellaneous information, 3-33, 
through 3-35 
modify terminal, 3-25 through 
3-28 
modify UCI and PAC, 3-23 through 
3-25 
multiplexer, 3-17, 3-18, 3-28 
through 3-30 
partition allocation, 3-4, 3-20 
through 3-22 
+SYS system global, F-1 through 
F-3 
System crash errors, 5-6, 5-7 
System Demo Package, 6-27, 6-28 
System device, 3-4, 3-14 through 
3-16 
System Exerciser Utility (TP7), 
6-28 
System generation procedures, 
3-1 through 3-36 
System library transfer, 3-22, 
3-23 
System merge, 2-13, 3-11, 3-12 
System parameters, changing, 
3-36, 6-12 
System stack, 3-8, 3-34 
System table error statistics, 
5-5, 5-6 
System Test Package, 6-27, 6-28 
System Timings Test (TP2), 6-28 - 
for other system components, 
please refer to the specific 
subject. 
System Utility and Test Programs, 
6-1 through 6-28 


Index-4 
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Tape identification, 1-2 
Tape logical structure, SYSGEN, 3-2 
Terminal device parameters, 3-25 
through 3-28 
Terminals, 
baud rates, 3-7, 3-28, 3-30 
connection procedures for non- 
standard devices, H-l 
stall counts for, 3-27, 3-28 
tied, 3-26 
Terminal-type devices, 3-14 
through 3-16 
Termination message, C-l, C-4 
Terminator symbol (./), xiii 
Terms, glossary of, A-1 through 
A-7 
Test package, 6-27, 6-28 
Test programs, 6-1, 6-27, 6-28 
Tied terminals, 3-26 
Time of system creation, 3-35 
TIM (Time Set) System Utility 
program, 3-36, 6-3, 6-25 
TM-1ll Magnetic Tape Test (TP6), 6-28 
TPl through TP8 (system test 
package), 6-27, 6-28 
Typing errors, 2-3 


UCI (User Class Identifier), 6-1 


for tied terminal, 3-26 
modification, 3-23 
Underlining, xiii 
Unloading procedures, Magtape, 
G-2 
Up arrow (+) to indicate CTRL 
command, xiii 
User Device Driver, 2-1 
Utility programs, 1-2, 
summary, 6-2, 6-3 


8 
1~3, 


VTO5, 50, 52, 55 Terminals, 
3-27 

VIEW command, illegal use of, 
5-2 


Write check, 3-34, 3-35 
Write errors, 5-3, 5-4 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 


O Assembly language programmer 

OC Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 


OOOO 


Non-programmer interested in computer concepts and capabilities 


Name Catt“ 
Organization 

Street 

City State Zp Code 


or 
Country 
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